svn: /phpdoc/ja/trunk/reference/win32service/ book.xml constants.xml functions/win32-continue-service.xml functions/win32-create-service.xml functions/win32-delete-service.xml functions/win32-get-last-control-message.xml functions/win32-pause-service.xml functions/win32-query-service-status.xml functions/win32-set-service-status.xml functions/win32-start-service-ctrl-dispatcher.xml functions/win32-start-service.xml functions/win32-stop-service.xml setup.xml win32serviceexception.xml

Modified: phpdoc/ja/trunk/reference/win32service/book.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/book.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/book.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 330340 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->

 <book xml:id="book.win32service" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>win32service</title>
@@ -18,6 +18,7 @@

  &reference.win32service.setup;
  &reference.win32service.constants;
+ &reference.win32service.win32serviceexception;
  &reference.win32service.examples;
  &reference.win32service.reference;


Modified: phpdoc/ja/trunk/reference/win32service/constants.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/constants.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/constants.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 346866 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <appendix xml:id="win32service.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -490,6 +490,11 @@
  </section>

  <section xml:id="win32service.constants.errors">
+    <note>
+    <para>
+      これらの定数は、Win32Service 1.0.0 以降では使えません。
+    </para>
+  </note>
   <table>
    <title>Win32 エラーコード</title>
    <tgroup cols="3">

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-continue-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-continue-service.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-continue-service.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350988 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.win32-continue-service" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>int</type><methodname>win32_continue_service</methodname>
+   <type>void</type><methodname>win32_continue_service</methodname>
    <methodparam><type>string</type><parameter>servicename</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>machine</parameter></methodparam>
   </methodsynopsis>
@@ -50,10 +50,27 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &win32service.noerror.false.error;
+   &return.void;
   </para>
+  <para>
+    バージョン 1.0.0 より前では、
+    &win32service.noerror.false.error;
+  </para>
  </refsect1>

+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+    <parameter>servicename</parameter> の値が空の場合は、
+    <classname>ValueError</classname> がスローされます。
+  </para>
+
+   <para>
+    エラーが発生した場合は、
+    <classname>Win32ServiceException</classname> がスローされます。
+   </para>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
   <para>
@@ -67,6 +84,30 @@
      </thead>
      <tbody>
       <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に <classname>Win32ServiceException</classname>
+        をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>void</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+      <row>
        <entry>PECL win32service 0.3.0</entry>
        <entry>
         ACLが別のアカウントに設定されていた場合、

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-create-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-create-service.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-create-service.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="2.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350988 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.win32-create-service" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>win32_create_service</methodname>
+   <type>void</type><methodname>win32_create_service</methodname>
    <methodparam><type>array</type><parameter>details</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>machine</parameter></methodparam>
   </methodsynopsis>
@@ -291,10 +291,66 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &win32service.noerror.false.error;
+   &return.void;
   </para>
+  <para>
+   バージョン 1.0.0 より前では、&win32service.noerror.false.error;
+  </para>
  </refsect1>

+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   <parameter>service</parameter> 引数が空の場合、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>path</parameter> 引数が渡されていないか、空の場合、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>svc_type</parameter> 引数が不正な場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>start_type</parameter> 引数が不正な場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>error_control</parameter> 引数が不正な場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>base_priority</parameter> 引数が不正な場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>recovery_delay</parameter> 引数が
+   0 と PHP_INT_MAX の間にない場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>recovery_action_1</parameter> 引数が不正な場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>recovery_action_2</parameter> 引数が不正な場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>recovery_action_3</parameter> 引数が不正な場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   <parameter>recovery_reset_period</parameter> 引数が
+   0 と PHP_INT_MAX の間にない場合は、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+  <para>
+   エラーが発生した場合は、<classname>Win32ServiceException</classname> がスローされます。
+  </para>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -385,6 +441,30 @@
      </thead>
      <tbody>
       <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>void</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+      <row>
        <entry>PECL win32service 0.4.0</entry>
        <entry>
         <parameter>dependencies</parameter>, <parameter>recovery_delay</parameter>,

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-delete-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-delete-service.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-delete-service.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 304597 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
+<!-- Credits: mumumu -->
 <refentry xml:id="function.win32-delete-service" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>win32_delete_service</refname>
@@ -10,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>win32_delete_service</methodname>
+   <type>void</type><methodname>win32_delete_service</methodname>
    <methodparam><type>string</type><parameter>servicename</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>machine</parameter></methodparam>
   </methodsynopsis>
@@ -54,10 +55,27 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &win32service.noerror.false.error;
+   &return.void;
   </para>
+  <para>
+    バージョン 1.0.0 より前では、
+    &win32service.noerror.false.error;
+  </para>
  </refsect1>

+
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+    <parameter>servicename</parameter> 引数が空の場合は、
+    <classname>ValueError</classname> がスローされます。
+  </para>
+
+   <para>
+    エラー時には <classname>Win32ServiceException</classname> がスローされます。
+   </para>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -77,6 +95,48 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>void</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-get-last-control-message.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-get-last-control-message.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-get-last-control-message.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350988 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.win32-get-last-control-message" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -34,21 +34,38 @@
    制御コード定数を返します。以下の
    <link linkend="win32service.constants.servicecontrol">Win32Service サービス制御メッセージ定数</link>
    のひとつです。
-   <constant>WIN32_SERVICE_CONTROL_CONTINUE</constant>、
-   <constant>WIN32_SERVICE_CONTROL_INTERROGATE</constant>、
-   <constant>WIN32_SERVICE_CONTROL_PAUSE</constant>、
-   <constant>WIN32_SERVICE_CONTROL_PRESHUTDOWN</constant>、
-   <constant>WIN32_SERVICE_CONTROL_SHUTDOWN</constant>、
+   <constant>WIN32_SERVICE_CONTROL_CONTINUE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_DEVICEEVENT</constant>,
+   <constant>WIN32_SERVICE_CONTROL_HARDWAREPROFILECHANGE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_INTERROGATE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_NETBINDADD</constant>,
+   <constant>WIN32_SERVICE_CONTROL_NETBINDDISABLE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_NETBINDENABLE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_NETBINDREMOVE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_PARAMCHANGE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_PAUSE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_POWEREVENT</constant>,
+   <constant>WIN32_SERVICE_CONTROL_PRESHUTDOWN</constant>,
+   <constant>WIN32_SERVICE_CONTROL_SESSIONCHANGE</constant>,
+   <constant>WIN32_SERVICE_CONTROL_SHUTDOWN</constant>,
    <constant>WIN32_SERVICE_CONTROL_STOP</constant>。
   </para>
+  <para>
+   値が 128 から 255 の場合、制御コードはカスタムの値です。
+  </para>
  </refsect1>

  <refsect1 role="errors"><!-- {{{ -->
   &reftitle.errors;
   <para>
-   SAPI が <literal>"cli"</literal> でない場合、
-   この関数は <constant>E_ERROR</constant> レベルのエラーを発生させます。
+   バージョン 1.0.0 より前のバージョンでは、SAPI が <literal>"cli"</literal> でない場合、
+   この関数は <constant>E_ERROR</constant> レベルのエラーを発生させていました。
   </para>
+   <para>
+    バージョン 1.0.0 移行は、
+    SAPI が <literal>"cli"</literal> でない場合、
+    <classname>Win32ServiceException</classname> がスローされます。
+   </para>
  </refsect1><!-- }}} -->

  <refsect1 role="changelog"><!-- {{{ -->
@@ -64,6 +81,23 @@
      </thead>
      <tbody>
       <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
        <entry>PECL win32service 0.2.0</entry>
        <entry>
         この関数は <literal>"cli"</literal> SAPI でのみ動作するようになりました。

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-pause-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-pause-service.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-pause-service.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350988 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.win32-pause-service" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>int</type><methodname>win32_pause_service</methodname>
+   <type>void</type><methodname>win32_pause_service</methodname>
    <methodparam><type>string</type><parameter>servicename</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>machine</parameter></methodparam>
   </methodsynopsis>
@@ -50,10 +50,27 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &win32service.noerror.false.error;
+   &return.void;
   </para>
+  <para>
+    バージョン 1.0.0 より前では、
+    &win32service.noerror.false.error;
+  </para>
  </refsect1>

+
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   <parameter>servicename</parameter> 引数が空の場合、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+
+   <para>
+    エラー時には <classname>Win32ServiceException</classname> がスローされます。
+   </para>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
   <para>
@@ -67,6 +84,30 @@
      </thead>
      <tbody>
       <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>void</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+      <row>
        <entry>PECL win32service 0.3.0</entry>
        <entry>
         ACLが別のアカウントに設定されていた場合、

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-query-service-status.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-query-service-status.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-query-service-status.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 346866 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="function.win32-query-service-status" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>win32_query_service_status</methodname>
+   <type>array</type><methodname>win32_query_service_status</methodname>
    <methodparam><type>string</type><parameter>servicename</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>machine</parameter></methodparam>
   </methodsynopsis>
@@ -48,9 +48,12 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   成功した場合に以下の情報を含む配列を返します。&win32service.false.error;
+   成功した場合に以下の情報を含む配列を返します。
   </para>
   <para>
+    バージョン 1.0.0 より前では、&win32service.false.error;
+  </para>
+  <para>
    <variablelist>
     <varlistentry>
      <term><parameter>ServiceType</parameter></term>
@@ -144,6 +147,57 @@

  </refsect1>

+
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+    <parameter>servicename</parameter> 引数が空の場合、
+    <classname>ValueError</classname> がスローされます。
+  </para>
+ </refsect1><!-- }}} -->
+
+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>array</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-set-service-status.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-set-service-status.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-set-service-status.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350988 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.win32-set-service-status" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>win32_set_service_status</methodname>
+   <type>void</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>
@@ -51,17 +51,18 @@
      <term><parameter>checkpoint</parameter></term>
      <listitem>
       <para>
-       The checkpoint 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.
+       start, stop, pause や continue の操作がとても時間がかかる場合に、
+       その状態を報告する目的で定期的にインクリメントされるチェックポイントの値。
+       たとえば、サービスが起動中の場合は、
+       初期化のステップがひとつ終了するたびに、
+       この値をインクリメントすべきです。
       </para>
       <para>
-       The <parameter>checkpoint</parameter> is only valid when the
-       <parameter>status</parameter> is one of
+       <parameter>checkpoint</parameter> の値は、
+       <parameter>status</parameter> が以下の場合のみ、正しい値です:
        <constant>WIN32_SERVICE_STOP_PENDING</constant>,
        <constant>WIN32_SERVICE_START_PENDING</constant>,
-       <constant>WIN32_SERVICE_CONTINUE_PENDING</constant> or
+       <constant>WIN32_SERVICE_CONTINUE_PENDING</constant>,
        <constant>WIN32_SERVICE_PAUSE_PENDING</constant>.
       </para>
      </listitem>
@@ -73,16 +74,25 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &win32service.success.false.error;
+   &return.void;
   </para>
+  <para>
+    バージョン 1.0.0 より前では、&win32service.noerror.false.error;
+  </para>
  </refsect1>

  <refsect1 role="errors"><!-- {{{ -->
   &reftitle.errors;
   <para>
+   バージョン 1.0.0 より前では、
    SAPI が <literal>"cli"</literal> でない場合、
-   この関数は <constant>E_ERROR</constant> レベルのエラーを発生させます。
+   この関数は <constant>E_ERROR</constant> レベルのエラーを発生させていました。
   </para>
+  <para>
+   バージョン 1.0.0 以降では、
+   SAPI が <literal>"cli"</literal> でない場合、
+   <classname>Win32ServiceException</classname> がスローされます。
+  </para>
  </refsect1><!-- }}} -->

  <refsect1 role="changelog"><!-- {{{ -->
@@ -98,6 +108,30 @@
      </thead>
      <tbody>
       <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>void</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+      <row>
        <entry>PECL win32service 0.2.0</entry>
        <entry>
         この関数は、<literal>"cli"</literal> SAPI でのみ動作するようになりました。

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-start-service-ctrl-dispatcher.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-start-service-ctrl-dispatcher.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-start-service-ctrl-dispatcher.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350988 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.win32-start-service-ctrl-dispatcher" xmlns="http://docbook.org/ns/docbook">
@@ -14,7 +14,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>win32_start_service_ctrl_dispatcher</methodname>
+   <type>void</type><methodname>win32_start_service_ctrl_dispatcher</methodname>
    <methodparam><type>string</type><parameter>name</parameter></methodparam>
    <methodparam choice="opt"><type>bool</type><parameter>gracefulMode</parameter><initializer>true</initializer></methodparam>
   </methodsynopsis>
@@ -75,10 +75,27 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &win32service.success.false.error;
+   &return.void;
   </para>
+  <para>
+    バージョン 1.0.0 より前では、&win32service.noerror.false.error;
+  </para>
  </refsect1>

+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   バージョン 1.0.0 より前では、
+   SAPI が <literal>"cli"</literal> でない場合、
+   この関数は <constant>E_ERROR</constant> レベルのエラーを発生させていました。
+  </para>
+  <para>
+   バージョン 1.0.0 以降では、
+   SAPI が <literal>"cli"</literal> でない場合、
+   <classname>Win32ServiceException</classname> がスローされます。
+  </para>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -124,6 +141,30 @@
      </thead>
      <tbody>
       <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>void</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+      <row>
        <entry>PECL win32service 0.4.0</entry>
        <entry>
         <parameter>gracefulMode</parameter> パラメータが追加されました。

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-start-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-start-service.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-start-service.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350988 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.win32-start-service" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>int</type><methodname>win32_start_service</methodname>
+   <type>void</type><methodname>win32_start_service</methodname>
    <methodparam><type>string</type><parameter>servicename</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>machine</parameter></methodparam>
   </methodsynopsis>
@@ -50,10 +50,28 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &win32service.noerror.false.error;
+   &return.void;
   </para>
+  <para>
+    バージョン 1.0.0 より前では、
+    &win32service.noerror.false.error;
+  </para>
  </refsect1>

+
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   <parameter>servicename</parameter> が空の場合、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+
+   <para>
+    エラー時には、<classname>Win32ServiceException</classname> がスローされます。
+   </para>
+ </refsect1><!-- }}} -->
+
+
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
   <para>
@@ -67,6 +85,30 @@
      </thead>
      <tbody>
       <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>void</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+      <row>
        <entry>PECL win32service 0.3.0</entry>
        <entry>
         ACLが別のアカウントに設定されていた場合、

Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-stop-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-stop-service.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-stop-service.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 350988 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.win32-stop-service" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>int</type><methodname>win32_stop_service</methodname>
+   <type>void</type><methodname>win32_stop_service</methodname>
    <methodparam><type>string</type><parameter>servicename</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>machine</parameter></methodparam>
   </methodsynopsis>
@@ -49,10 +49,28 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &win32service.noerror.false.error;
+   &return.void;
   </para>
+  <para>
+    バージョン 1.0.0 より前では、
+    &win32service.noerror.false.error;
+  </para>
  </refsect1>

+
+ <refsect1 role="errors"><!-- {{{ -->
+  &reftitle.errors;
+  <para>
+   <parameter>servicename</parameter> 引数が空の場合、
+   <classname>ValueError</classname> がスローされます。
+  </para>
+
+   <para>
+    エラー時には、<classname>Win32ServiceException</classname> がスローされます。
+   </para>
+ </refsect1><!-- }}} -->
+
+
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
   <para>
@@ -66,6 +84,30 @@
      </thead>
      <tbody>
       <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        引数に不正な値があった場合、
+        <classname>ValueError</classname> をスローするようになりました。
+        これより前のバージョンでは、&false; を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        エラー時に
+        <classname>Win32ServiceException</classname> をスローするようになりました。
+        これより前のバージョンでは、
+        <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返していました。
+       </entry>
+      </row>
+      <row>
+       <entry>PECL win32service 1.0.0</entry>
+       <entry>
+        返り値の型が <type>void</type> になりました。
+        これより前のバージョンでは、<type>mixed</type> でした。
+       </entry>
+      </row>
+      <row>
        <entry>PECL win32service 0.3.0</entry>
        <entry>
         ACLが別のアカウントに設定されていた場合、

Modified: phpdoc/ja/trunk/reference/win32service/setup.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/setup.xml	2020-11-30 00:43:37 UTC (rev 351758)
+++ phpdoc/ja/trunk/reference/win32service/setup.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 345077 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351746 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->

 <chapter xml:id="win32service.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -10,8 +10,9 @@
  <section xml:id="win32service.requirements">
   &reftitle.required;
   <para>
-   Windows NT、Windows 2000、Windows XP あるいは Windows Server 2003
-   が必要です。Windows NT 系の Windows に対応しています。
+   サポートされているWindows のバージョンは、
+   PHP をビルドするのに使う
+   Visual C++ 再頒布可能パッケージ がサポートするバージョンと同じです。
   </para>
  </section>
  <!-- }}} -->

Added: phpdoc/ja/trunk/reference/win32service/win32serviceexception.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/win32serviceexception.xml	                        (rev 0)
+++ phpdoc/ja/trunk/reference/win32service/win32serviceexception.xml	2020-11-30 00:57:13 UTC (rev 351759)
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 351746 Maintainer: mumumu Status: ready -->
+
+<phpdoc:exceptionref xml:id="class.win32serviceexception"
+ xmlns:phpdoc="http://php.net/ns/phpdoc"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xmlns="http://docbook.org/ns/docbook">
+ <title>The Win32ServiceException class</title>
+ <titleabbrev>Win32ServiceException</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ win32serviceexception intro -->
+  <section xml:id="win32serviceexception.intro">
+   &reftitle.intro;
+   <para>
+    この例外は、
+    エラーを検知するために、
+    定数と比較する必要があった古いやり方を置き換えるものです。
+    この例外が持つコードは、対応する定数の値と等しく、
+    例外メッセージも対応する定数名に基づいています。
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="win32serviceexception.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>Win32ServiceException</classname></ooclass>
+
+<!-- {{{ Exception synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <classname>Win32ServiceException</classname>
+     </ooclass>
+
+     <ooclass>
+      <modifier>extends</modifier>
+      <classname>Exception</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+
+    <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
+     <xi:fallback />
+    </xi:include>
+
+<!-- Comment this section out if the exception does not contain any methods -->
+<!--
+    <classsynopsisinfo role="comment">Methods</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.win32serviceexception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+-->
+<!-- If the exception extends another exception use this -->
+   <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ <!-- If the exception has any methods you'd like to document use this
+ &reference.extname.entities.classname;
+ -->
+
+</phpdoc:exceptionref>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ja/trunk/reference/win32service/win32serviceexception.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property