Added checkpoints for SetSericeStatus.

Added description and delayed start (Vista/2008 + only) for CreateService.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@304552 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Richard Quadling 2010-10-20 09:14:21 +00:00
parent 2d4d3da13b
commit 4e2d691e18
2 changed files with 48 additions and 0 deletions

View file

@ -43,6 +43,14 @@
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>description</parameter></term>
<listitem>
<para>The long description of the service. This is the description
that you will see in the Services Applet.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>user</parameter></term>
<listitem>
@ -122,6 +130,26 @@
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>delayed_start</parameter></term>
<listitem>
<para>
If <parameter>delayed_start</parameter> is set to &true;, then this
will inform the SCM that this service should be started after other
auto-start services are started plus a short delay.
</para>
<para>
Any service can be marked as a delayed auto-start service; however,
this setting has no effect unless the service's
<parameter>start_type</parameter> is
<constant>WIN32_SERVICE_AUTO_START</constant>.
</para>
<para>
This setting is only applicable on Windows Vista and Windows Server
2008 or greater.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>

View file

@ -11,6 +11,7 @@
<methodsynopsis>
<type>bool</type><methodname>win32_set_service_status</methodname>
<methodparam><type>int</type><parameter>status</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>checkpoint</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Informs the SCM of the current status of a running service.
@ -36,6 +37,25 @@
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>checkpoint</parameter></term>
<listitem>
<para>
The check-point value the service increments periodically to report its
progress during a lengthy start, stop, pause, or continue operation.
For example, the service should increment this value as it completes
each step of its initialization when it is starting up.
</para>
<para>
The <parameter>checkpoint</parameter> is only valid when the
<parameter>status</parameter> is one of
<constant>WIN32_SERVICE_STOP_PENDING</constant>,
<constant>WIN32_SERVICE_START_PENDING</constant>,
<constant>WIN32_SERVICE_CONTINUE_PENDING</constant> or
<constant>WIN32_SERVICE_PAUSE_PENDING</constant>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>