From 4e2d691e18c56a0ab410e01f6c33b8ed479a3571 Mon Sep 17 00:00:00 2001
From: Richard Quadling <rquadling@php.net>
Date: Wed, 20 Oct 2010 09:14:21 +0000
Subject: [PATCH] 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
---
 .../functions/win32-create-service.xml        | 28 +++++++++++++++++++
 .../functions/win32-set-service-status.xml    | 20 +++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/reference/win32service/functions/win32-create-service.xml b/reference/win32service/functions/win32-create-service.xml
index 149e06e384..e6a71042df 100644
--- a/reference/win32service/functions/win32-create-service.xml
+++ b/reference/win32service/functions/win32-create-service.xml
@@ -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>
diff --git a/reference/win32service/functions/win32-set-service-status.xml b/reference/win32service/functions/win32-set-service-status.xml
index e1a324aadd..ebc6909d40 100644
--- a/reference/win32service/functions/win32-set-service-status.xml
+++ b/reference/win32service/functions/win32-set-service-status.xml
@@ -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>