svn: /phpdoc/ja/trunk/reference/win32service/ constants.xml functions/win32-continue-service.xml functions/win32-create-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
[email protected] (Yoshinari Takaoka)
| Newsgroups | php.doc.ja |
|---|---|
| Message-ID | <[email protected]> |
mumumu Mon, 20 Jan 2020 18:18:25 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=348982
Log:
updated overall win32service related doc translations
Changed paths:
U phpdoc/ja/trunk/reference/win32service/constants.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-continue-service.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-create-service.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-get-last-control-message.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-pause-service.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-query-service-status.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-set-service-status.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-start-service-ctrl-dispatcher.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-start-service.xml
U phpdoc/ja/trunk/reference/win32service/functions/win32-stop-service.xml
U phpdoc/ja/trunk/reference/win32service/setup.xml
svn-diffs-348982.txt
(text/x-diff, 49.9 KB)
Modified: phpdoc/ja/trunk/reference/win32service/constants.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/constants.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/constants.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334762 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346866 Maintainer: takagi Status: working -->
+<!-- Credits: mumumu -->
<appendix xml:id="win32service.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
@@ -128,6 +129,18 @@
停止中のサービスに再開を指示します。
</entry>
</row>
+ <row xml:id="constant.win32-service-control-deviceevent">
+ <entry><constant>WIN32_SERVICE_CONTROL_DEVICEEVENT</constant></entry>
+ <entry>0x0000000B</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-control-hardwareprofilechange">
+ <entry><constant>WIN32_SERVICE_CONTROL_HARDWAREPROFILECHANGE</constant></entry>
+ <entry>0x0000000C</entry>
+ <entry>
+ </entry>
+ </row>
<row xml:id="constant.win32-service-control-interrogate">
<entry><constant>WIN32_SERVICE_CONTROL_INTERROGATE</constant></entry>
<entry>0x00000004</entry>
@@ -135,6 +148,41 @@
現状の情報をサービス制御マネージャーに報告するようサービスに指示します。
</entry>
</row>
+ <row xml:id="constant.win32-service-control-netbindadd">
+ <entry><constant>WIN32_SERVICE_CONTROL_NETBINDADD</constant></entry>
+ <entry>0x00000007</entry>
+ <entry>
+ バインドする新しいコンポーネントがあった場合、ネットワークサービスに通知します。
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-control-netbinddisable">
+ <entry><constant>WIN32_SERVICE_CONTROL_NETBINDDISABLE</constant></entry>
+ <entry>0x0000000A</entry>
+ <entry>
+ バインドされているコンポーネントが無効にされた場合、ネットワークサービスに通知します。
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-control-netbindenable">
+ <entry><constant>WIN32_SERVICE_CONTROL_NETBINDENABLE</constant></entry>
+ <entry>0x00000009</entry>
+ <entry>
+ 無効にされていたバインディングが有効になった場合、ネットワークサービスに通知します。
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-control-netbindremove">
+ <entry><constant>WIN32_SERVICE_CONTROL_NETBINDREMOVE</constant></entry>
+ <entry>0x00000008</entry>
+ <entry>
+ バインドされているコンポーネントが削除された場合、ネットワークサービスに通知します。
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-control-paramchange">
+ <entry><constant>WIN32_SERVICE_CONTROL_PARAMCHANGE</constant></entry>
+ <entry>0x00000006</entry>
+ <entry>
+ 起動時のパラメータが変更されたことをサービスに通知します。
+ </entry>
+ </row>
<row xml:id="constant.win32-service-control-pause">
<entry><constant>WIN32_SERVICE_CONTROL_PAUSE</constant></entry>
<entry>0x00000002</entry>
@@ -142,6 +190,12 @@
サービスに停止するよう指示します。
</entry>
</row>
+ <row xml:id="constant.win32-service-control-powerevent">
+ <entry><constant>WIN32_SERVICE_CONTROL_POWEREVENT</constant></entry>
+ <entry>0x0000000D</entry>
+ <entry>
+ </entry>
+ </row>
<row xml:id="constant.win32-service-control-preshutdown">
<entry><constant>WIN32_SERVICE_CONTROL_PRESHUTDOWN</constant></entry>
<entry>0x0000000F</entry>
@@ -152,6 +206,12 @@
この値は、Windows Server 2003 および Windows XP/2000 以降では使えません。
</entry>
</row>
+ <row xml:id="constant.win32-service-control-sessionchange">
+ <entry><constant>WIN32_SERVICE_CONTROL_SESSIONCHANGE</constant></entry>
+ <entry>0x0000000E</entry>
+ <entry>
+ </entry>
+ </row>
<row xml:id="constant.win32-service-control-shutdown">
<entry><constant>WIN32_SERVICE_CONTROL_SHUTDOWN</constant></entry>
<entry>0x00000005</entry>
@@ -186,6 +246,38 @@
</row>
</thead>
<tbody>
+ <row xml:id="constant.win32-service-accept-hardwareprofilechange">
+ <entry><constant>WIN32_SERVICE_ACCEPT_HARDWAREPROFILECHANGE</constant></entry>
+ <entry>0x00000020</entry>
+ <entry>
+ The service is notified when the computer's hardware profile has changed.
+ This enables the system to send
+ <constant>WIN32_SERVICE_CONTROL_HARDWAREPROFILECHANGE</constant>
+ notifications to the service.
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-accept-netbindchange">
+ <entry><constant>WIN32_SERVICE_ACCEPT_NETBINDCHANGE</constant></entry>
+ <entry>0x00000010</entry>
+ <entry>
+ The service is a network component that can accept changes in its
+ binding without being stopped and restarted.
+ This control code allows the service to receive
+ <constant>WIN32_SERVICE_CONTROL_NETBINDADD</constant>,
+ <constant>WIN32_SERVICE_CONTROL_NETBINDREMOVE</constant>,
+ <constant>WIN32_SERVICE_CONTROL_NETBINDENABLE</constant>, and
+ <constant>WIN32_SERVICE_CONTROL_NETBINDDISABLE</constant> notifications.
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-accept-paramchange">
+ <entry><constant>WIN32_SERVICE_ACCEPT_PARAMCHANGE</constant></entry>
+ <entry>0x00000008</entry>
+ <entry>
+ The service can reread its startup parameters without being stopped and restarted.
+ This control code allows the service to receive
+ <constant>WIN32_SERVICE_CONTROL_PARAMCHANGE</constant> notifications.
+ </entry>
+ </row>
<row xml:id="constant.win32-service-accept-pause-continue">
<entry><constant>WIN32_SERVICE_ACCEPT_PAUSE_CONTINUE</constant></entry>
<entry>0x00000002</entry>
@@ -195,6 +287,16 @@
<constant>WIN32_SERVICE_CONTROL_CONTINUE</constant> の通知を受け取れることを表します。
</entry>
</row>
+ <row xml:id="constant.win32-service-accept-powerevent">
+ <entry><constant>WIN32_SERVICE_ACCEPT_POWEREVENT</constant></entry>
+ <entry>0x00000040</entry>
+ <entry>
+ The service is notified when the computer's power status has changed.
+ This enables the system to send
+ <constant>WIN32_SERVICE_CONTROL_POWEREVENT</constant> notifications
+ to the service.
+ </entry>
+ </row>
<row xml:id="constant.win32-service-accept-preshutdown">
<entry><constant>WIN32_SERVICE_ACCEPT_PRESHUTDOWN</constant></entry>
<entry>0x00000100</entry>
@@ -204,6 +306,17 @@
この値は Windows Server 2003 や Windows XP/2000 以降では使えません。
</entry>
</row>
+ <row xml:id="constant.win32-service-accept-sessionchange">
+ <entry><constant>WIN32_SERVICE_ACCEPT_SESSIONCHANGE</constant></entry>
+ <entry>0x00000080</entry>
+ <entry>
+ The service is notified when the computer's session status has changed.
+ This enables the system to send
+ <constant>WIN32_SERVICE_CONTROL_SESSIONCHANGE</constant> notifications
+ to the service.
+ Windows 2000: This value is not supported
+ </entry>
+ </row>
<row xml:id="constant.win32-service-accept-shutdown">
<entry><constant>WIN32_SERVICE_ACCEPT_SHUTDOWN</constant></entry>
<entry>0x00000004</entry>
@@ -220,6 +333,28 @@
<constant>WIN32_SERVICE_CONTROL_STOP</constant> の通知を受け取れることを表します。
</entry>
</row>
+ <row xml:id="constant.win32-service-accept-timechange">
+ <entry><constant>WIN32_SERVICE_ACCEPT_TIMECHANGE</constant></entry>
+ <entry>0x00000200</entry>
+ <entry>
+ The service is notified when the system time has changed.
+ This enables the system to send
+ <constant>WIN32_SERVICE_CONTROL_TIMECHANGE</constant> notifications to the service.
+ Windows Server 2008, Windows Vista, Windows Server 2003,
+ and Windows XP/2000: This control code is not supported.
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-accept-triggerevent">
+ <entry><constant>WIN32_SERVICE_ACCEPT_TRIGGEREVENT</constant></entry>
+ <entry>0x00000400</entry>
+ <entry>
+ The service is notified when an event for which the service has registered occurs.
+ This enables the system to send
+ <constant>WIN32_SERVICE_CONTROL_TRIGGEREVENT</constant> notifications to the service.
+ Windows Server 2008, Windows Vista, Windows Server 2003,
+ and Windows XP/2000: This control code is not supported.
+ </entry>
+ </row>
</tbody>
</tgroup>
</table>
@@ -237,6 +372,20 @@
</row>
</thead>
<tbody>
+ <row xml:id="constant.win32-service-boot-start">
+ <entry><constant>WIN32_SERVICE_BOOT_START</constant></entry>
+ <entry>0x00000000</entry>
+ <entry>
+ A device driver started by the system loader. This value is valid only for driver services.
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-system-start">
+ <entry><constant>WIN32_SERVICE_SYSTEM_START</constant></entry>
+ <entry>0x00000001</entry>
+ <entry>
+ A device driver started by the IoInitSystem function. This value is valid only for driver services.
+ </entry>
+ </row>
<row xml:id="constant.win32-service-auto-start">
<entry><constant>WIN32_SERVICE_AUTO_START</constant></entry>
<entry>0x00000002</entry>
@@ -291,6 +440,26 @@
起動プログラムはエラーをイベントログに記録し、開始操作を続行します。
</entry>
</row>
+ <row xml:id="constant.win32-service-error-severe">
+ <entry><constant>WIN32_SERVICE_ERROR_SEVERE</constant></entry>
+ <entry>0x00000002</entry>
+ <entry>
+ The startup program logs the error in the event log.
+ If the last-known-good configuration is being started, the startup
+ operation continues. Otherwise, the system is restarted with the
+ last-known-good configuration.
+ </entry>
+ </row>
+ <row xml:id="constant.win32-service-error-critical">
+ <entry><constant>WIN32_SERVICE_ERROR_CRITICAL</constant></entry>
+ <entry>0x00000003</entry>
+ <entry>
+ The startup program logs the error in the event log, if possible.
+ If the last-known-good configuration is being started, the startup
+ operation fails. Otherwise, the system is restarted with the
+ last-known good configuration.
+ </entry>
+ </row>
</tbody>
</tgroup>
</table>
@@ -544,6 +713,13 @@
システムがシャットダウン中なので、この関数はコールできません。
</entry>
</row>
+ <row xml:id="constant.win32-error-service-specific-error">
+ <entry><constant>WIN32_ERROR_SERVICE_SPECIFIC_ERROR</constant></entry>
+ <entry>0x0000042A</entry>
+ <entry>
+ The service has returned a service-specific error code.
+ </entry>
+ </row>
<row xml:id="constant.win32-no-error">
<entry><constant>WIN32_NO_ERROR</constant></entry>
<entry>0x00000000</entry>
@@ -632,6 +808,199 @@
</table>
</section>
+ <section xml:id="win32service.constants.recovery-action">
+ <table>
+ <title>Win32 Recovery action</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Constant</entry>
+ <entry>Value</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row xml:id="constant.win32-sc-action-none">
+ <entry><constant>WIN32_SC_ACTION_NONE</constant></entry>
+ <entry>0x00000000</entry>
+ <entry>
+ No action.
+ </entry>
+ </row>
+ <row xml:id="constant.win32-sc-action-reboot">
+ <entry><constant>WIN32_SC_ACTION_REBOOT</constant></entry>
+ <entry>0x00000001</entry>
+ <entry>
+ Restart the server.
+ </entry>
+ </row>
+ <row xml:id="constant.win32-sc-action-restart">
+ <entry><constant>WIN32_SC_ACTION_RESTART</constant></entry>
+ <entry>0x00000002</entry>
+ <entry>
+ Restart the service.
+ </entry>
+ </row>
+ <row xml:id="constant.win32-sc-action-run-command">
+ <entry><constant>WIN32_SC_ACTION_RUN_COMMAND</constant></entry>
+ <entry>0x00000003</entry>
+ <entry>
+ Run a command.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+
+ <section xml:id="win32service.constants.serviceinfos">
+ <table>
+ <title>Win32 Service informations</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Constant</entry>
+ <entry>Value</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row xml:id="constant.win32-info-service">
+ <entry><constant>WIN32_INFO_SERVICE</constant></entry>
+ <entry>"service"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-display">
+ <entry><constant>WIN32_INFO_DISPLAY</constant></entry>
+ <entry>"display"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-user">
+ <entry><constant>WIN32_INFO_USER</constant></entry>
+ <entry>"user"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-password">
+ <entry><constant>WIN32_INFO_PASSWORD</constant></entry>
+ <entry>"password"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-path">
+ <entry><constant>WIN32_INFO_PATH</constant></entry>
+ <entry>"path"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-params">
+ <entry><constant>WIN32_INFO_PARAMS</constant></entry>
+ <entry>"params"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-description">
+ <entry><constant>WIN32_INFO_DESCRIPTION</constant></entry>
+ <entry>"description"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-start-type">
+ <entry><constant>WIN32_INFO_START_TYPE</constant></entry>
+ <entry>"start_type"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-load-order">
+ <entry><constant>INFO_LOAD_ORDER</constant></entry>
+ <entry>"load_order"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-svc-type">
+ <entry><constant>INFO_SVC_TYPE</constant></entry>
+ <entry>"svc_type"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-error-control">
+ <entry><constant>INFO_ERROR_CONTROL</constant></entry>
+ <entry>"error_control"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-delayed-start">
+ <entry><constant>INFO_DELAYED_START</constant></entry>
+ <entry>"delayed_start"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-base-priority">
+ <entry><constant>INFO_BASE_PRIORITY</constant></entry>
+ <entry>"base_priority"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-dependencies">
+ <entry><constant>INFO_DEPENDENCIES</constant></entry>
+ <entry>"dependencies"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-recovery-delay">
+ <entry><constant>INFO_RECOVERY_DELAY</constant></entry>
+ <entry>"recovery_delay"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-recovery-action-1">
+ <entry><constant>INFO_RECOVERY_ACTION_1</constant></entry>
+ <entry>"recovery_action_1"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-recovery-action-2">
+ <entry><constant>INFO_RECOVERY_ACTION_2</constant></entry>
+ <entry>"recovery_action_2"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-recovery-action-3">
+ <entry><constant>INFO_RECOVERY_ACTION_3</constant></entry>
+ <entry>"recovery_action_3"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-recovery-reset-period">
+ <entry><constant>INFO_RECOVERY_RESET_PERIOD</constant></entry>
+ <entry>"recovery_reset_period"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-recovery-enabled">
+ <entry><constant>INFO_RECOVERY_ENABLED</constant></entry>
+ <entry>"recovery_enabled"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-recovery-reboot-msg">
+ <entry><constant>INFO_RECOVERY_REBOOT_MSG</constant></entry>
+ <entry>"recovery_reboot_msg"</entry>
+ <entry>
+ </entry>
+ </row>
+ <row xml:id="constant.win32-info-recovery-command">
+ <entry><constant>INFO_RECOVERY_COMMAND</constant></entry>
+ <entry>"recovery_command"</entry>
+ <entry>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
</appendix>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-continue-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-continue-service.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-continue-service.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 317663 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346737 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">
<refnamediv>
<refname>win32_continue_service</refname>
@@ -16,7 +17,9 @@
</methodsynopsis>
<para>
- 指定した名前の、中断しているサービスを再開します。管理者権限が必要です。
+ 指定した名前の、中断しているサービスを再開します。
+ 管理者権限、
+ またはサービスのACLで適切な権限が設定されたアカウントが必要です。
</para>
</refsect1>
@@ -51,11 +54,39 @@
</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>0.3.0</entry>
+ <entry>
+ ACLが別のアカウントに設定されていた場合、
+ この関数は管理者権限を必要としなくなりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1><!-- }}} -->
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>win32_start_service</function></member>
+ <member><function>win32_stop_service</function></member>
+ <member><function>win32_pause_service</function></member>
+ <member><function>win32_send_custom_control</function></member>
<member><link linkend="win32service.constants.errors">Win32 エラーコード</link></member>
</simplelist>
</para>
Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-create-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-create-service.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-create-service.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 305252 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346868 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">
<refnamediv>
<refname>win32_create_service</refname>
@@ -14,6 +15,10 @@
<methodparam><type>array</type><parameter>details</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>machine</parameter></methodparam>
</methodsynopsis>
+ <para>
+ SCM データベースに新しいサービスの追加を試みます。
+ この操作を成功させるには、管理者権限が必要です。
+ </para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -162,6 +167,111 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><parameter>dependencies</parameter></term>
+ <listitem>
+ <para>
+ サービスへの依存性を定義します。
+ サービス名の一覧を配列として設定する必要があるかもしれません。
+ </para>
+ </listitem>
+ </varlistentry>
+ <!-- to be translated -->
+ <varlistentry>
+ <term><parameter>recovery_delay</parameter></term>
+ <listitem>
+ <para>
+ 失敗時とリカバリアクションの実行の間に取る時間を定義します。
+ この値はマイクロ秒単位です。
+ </para>
+ <para>
+ デフォルトは 60000 です。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>recovery_action_1</parameter></term>
+ <listitem>
+ <para>
+ 最初の失敗時に実行されるアクションです。
+ デフォルトの値は <constant>WIN32_SC_ACTION_NONE</constant> です。
+ </para>
+ <para>
+ <parameter>recovery_action_1</parameter> は、
+ <link linkend="win32service.constants.recovery-action">Win32 Recovery action</link>
+ で定義された定数のうちのひとつを設定できます。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>recovery_action_2</parameter></term>
+ <listitem>
+ <para>
+ 二回目の失敗時に実行されるアクションです。
+ デフォルトの値は <constant>WIN32_SC_ACTION_NONE</constant> です。
+ </para>
+ <para>
+ <parameter>recovery_action_2</parameter> は、
+ <link linkend="win32service.constants.recovery-action">Win32 Recovery action</link>
+ で定義された定数のうちのひとつを設定できます。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>recovery_action_3</parameter></term>
+ <listitem>
+ <para>
+ 3回目以降の失敗時に実行されるアクションです。
+ デフォルトの値は <constant>WIN32_SC_ACTION_NONE</constant> です。
+ </para>
+ <para>
+ <parameter>recovery_action_3</parameter> は、
+ <link linkend="win32service.constants.recovery-action">Win32 Recovery action</link>
+ で定義された定数のうちのひとつを設定できます。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>recovery_reset_period</parameter></term>
+ <listitem>
+ <para>
+ ここで定義された時間が経過すると、失敗のカウンタがリセットされます。
+ 秒単位で設定します。
+ </para>
+ <para>
+ デフォルト値は <literal>86400</literal> です。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>recovery_enabled</parameter></term>
+ <listitem>
+ <para>
+ リカバリ設定を有効にする場合は &true; を設定します。
+ 無効にする場合は &false; を設定します。
+ </para>
+ <para>
+ デフォルトは &false; です。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>recovery_reboot_msg</parameter></term>
+ <listitem>
+ <para>
+ リブート時に Windows のイベントログに記録されるメッセージを設定します。
+ アクションを <constant>WIN32_SC_ACTION_REBOOT</constant> に設定する場合にだけ使ってください。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>recovery_command</parameter></term>
+ <listitem>
+ <para>
+ アクションが <constant>WIN32_SC_ACTION_RUN_COMMAND</constant> に設定された場合に、実行されるコマンドを設定します。
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</listitem>
@@ -198,10 +308,10 @@
<![CDATA[
<?php
$x = win32_create_service(array(
- 'service' => 'dummyphp', # サービスの名前
- 'display' => 'sample dummy PHP service', # 短い説明
- 'description' => 'This is a dummy Windows service created using PHP.', # 長い説明
- 'params' => '"' . __FILE__ . '" run', # スクリプトへのパスとパラメータ
+ 'service' => 'dummyphp', // サービスの名前
+ 'display' => 'sample dummy PHP service', // 短い説明
+ 'description' => 'This is a dummy Windows service created using PHP.', // 長い説明
+ 'params' => '"' . __FILE__ . '" run', // スクリプトへのパスとパラメータ
));
debug_zval_dump($x);
?>
@@ -209,15 +319,96 @@
</programlisting>
</example>
</para>
+ <para>
+ <example>
+ <title>依存性を用いた <function>win32_create_service</function> の例</title>
+ <para>
+ 依存性がある 'dummyphp' というショートネームのサービスを作ります。
+ </para>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$x = win32_create_service(array(
+ 'service' => 'dummyphp', // サービスの名前
+ 'display' => 'sample dummy PHP service', // 短い説明
+ 'description' => 'This is a dummy Windows service created using PHP.', // 長い説明
+ 'params' => '"' . __FILE__ . '" run', // スクリプトへのパスとパラメータ
+ 'dependencies' => array("Netman"), // 依存性のリスト
+));
+debug_zval_dump($x);
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>リカバリ設定を用いた <function>win32_create_service</function> の例</title>
+ <para>
+ リカバリ設定がある 'dummyphp' というショートネームのサービスを作ります。
+ </para>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$x = win32_create_service(array(
+ 'service' => 'dummyphp', // サービスの名前
+ 'display' => 'sample dummy PHP service', // 短い説明
+ 'description' => 'This is a dummy Windows service created using PHP.', // 長い説明
+ 'params' => '"' . __FILE__ . '" run', // スクリプトへのパスとパラメータ
+ 'recovery_delay' => 120000, // 2分後に実行されるリカバリアクション
+ 'recovery_action_1' => WIN32_SC_ACTION_RESTART, // 最初の失敗時にサービスを再起動する
+ 'recovery_action_2' => WIN32_SC_ACTION_RUN_COMMAND, // 2回目の失敗時にはコマンドを実行
+ 'recovery_action_3' => WIN32_SC_ACTION_NONE, // その他の失敗時には何もしない
+ 'recovery_reset_period' => 86400, // 1日後には失敗のカウンタをリセット
+ 'recovery_enabled' => true, // リカバリパラメータを有効にする
+ 'recovery_reboot_msg' => null, // 不要ならリブート時のメッセージは定義するな
+ 'recovery_command' => "c:\clean-service.bat", // アクションが WIN32_SC_ACTION_RUN_COMMAND の場合、このコマンドが実行される
+));
+debug_zval_dump($x);
+?>
+]]>
+ </programlisting>
+ </example>
+ </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>0.4.0</entry>
+ <entry>
+ <parameter>dependencies</parameter>, <parameter>recovery_delay</parameter>,
+ <parameter>recovery_action_1</parameter>, <parameter>recovery_action_2</parameter>,
+ <parameter>recovery_action_3</parameter>, <parameter>recovery_reset_period</parameter>,
+ <parameter>recovery_enabled</parameter>, <parameter>recovery_reboot_msg</parameter>
+ および <parameter>recovery_command</parameter> パラメータが追加されました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1><!-- }}} -->
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>win32_delete_service</function></member>
- <member><link linkend="win32service.constants.basepriorities">Win32 ベース優先度クラス</link></member>
- <member><link linkend="win32service.constants.errors">Win32 エラーコード</link></member>
+ <member><link linkend="win32service.constants.basepriorities">Win32 Base Priority Classes</link></member>
+ <member><link linkend="win32service.constants.recovery-action">Win32 Recovery action</link></member>
+ <member><link linkend="win32service.constants.errors">Win32 Error Codes</link></member>
</simplelist>
</para>
</refsect1>
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-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-get-last-control-message.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 304596 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346737 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu -->
<refentry xml:id="function.win32-get-last-control-message" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>win32_get_last_control_message</refname>
@@ -19,6 +20,13 @@
定期的にこれをチェックすべきです。
</para>
+ <caution>
+ <para>
+ 0.2.0 以降では、この関数は "cli" SAPI でのみ動作します。
+ 他の SAPI では、この関数は無効になっています。
+ </para>
+ </caution>
+
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
@@ -35,11 +43,46 @@
</para>
</refsect1>
+ <refsect1 role="errors"><!-- {{{ -->
+ &reftitle.errors;
+ <para>
+ SAPI が <literal>"cli"</literal> でない場合、
+ この関数は <constant>E_ERROR</constant> レベルのエラーを発生させます。
+ </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>0.2.0</entry>
+ <entry>
+ この関数は <literal>"cli"</literal> SAPI でのみ動作するようになりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1><!-- }}} -->
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>win32_start_service_ctrl_dispatcher</function></member>
+ <member><function>win32_set_service_status</function></member>
+ <member><function>win32_set_service_exit_mode</function></member>
+ <member><function>win32_set_service_exit_code</function></member>
<member><link linkend="win32service.constants.servicecontrol">Win32Service サービス制御メッセージ定数</link></member>
</simplelist>
</para>
Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-pause-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-pause-service.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-pause-service.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 317663 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346737 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">
<refnamediv>
<refname>win32_pause_service</refname>
@@ -16,7 +17,9 @@
</methodsynopsis>
<para>
- 指定した名前のサービスを中断します。管理者権限が必要です。
+ 指定した名前のサービスを中断します。
+ 管理者権限、
+ またはサービスのACLで適切な権限が設定されたアカウントが必要です。
</para>
</refsect1>
@@ -51,11 +54,39 @@
</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>0.3.0</entry>
+ <entry>
+ ACLが別のアカウントに設定されていた場合、
+ この関数は管理者権限を必要としなくなりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1><!-- }}} -->
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>win32_start_service</function></member>
+ <member><function>win32_stop_service</function></member>
+ <member><function>win32_continue_service</function></member>
+ <member><function>win32_send_custom_control</function></member>
<member><link linkend="win32service.constants.errors">Win32 エラーコード</link></member>
</simplelist>
</para>
Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-query-service-status.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-query-service-status.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-query-service-status.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 304597 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346866 Maintainer: takagi Status: ready -->
<!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
-<!-- CREDITS: shimooka -->
+<!-- CREDITS: shimooka,mumumu -->
<refentry xml:id="function.win32-query-service-status" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>win32_query_service_status</refname>
@@ -85,6 +85,10 @@
<listitem>
<para>
サービスが終了した際にプロセスが返すコード。
+ この値は終了モードがgracefulでなかった場合、
+ <constant>WIN32_ERROR_SERVICE_SPECIFIC_ERROR</constant> と同じです。
+ <link linkend="win32service.constants.errors">Win32Service エラーコード</link> および
+ <function>win32_set_service_exit_mode</function> も参照してください。
</para>
</listitem>
</varlistentry>
@@ -93,6 +97,7 @@
<listitem>
<para>
サービスが異常終了した際にイベントログに記録されるコード。
+ この値は <function>win32_set_service_exit_code</function> で定義された値と同じです。
</para>
</listitem>
</varlistentry>
Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-set-service-status.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-set-service-status.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-set-service-status.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 304597 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346737 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">
<refnamediv>
<refname>win32_set_service_status</refname>
@@ -18,6 +19,14 @@
SCM に、実行中のサービスの現在の状態を通知します。
この関数のコールは、現在実行中のサービスについてのみ有効です。
</para>
+
+ <caution>
+ <para>
+ バージョン 0.2.0 以降は、この関数は "cli" SAPI でのみ動作します。
+ 他の SAPI では、この関数は無効になっています。
+ </para>
+ </caution>
+
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -68,11 +77,46 @@
</para>
</refsect1>
+ <refsect1 role="errors"><!-- {{{ -->
+ &reftitle.errors;
+ <para>
+ SAPI が <literal>"cli"</literal> でない場合、
+ この関数は <constant>E_ERROR</constant> レベルのエラーを発生させます。
+ </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>0.2.0</entry>
+ <entry>
+ この関数は、<literal>"cli"</literal> SAPI でのみ動作するようになりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1><!-- }}} -->
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>win32_start_service_ctrl_dispatcher</function></member>
+ <member><function>win32_get_last_control_message</function></member>
+ <member><function>win32_set_service_exit_mode</function></member>
+ <member><function>win32_set_service_exit_code</function></member>
<member><link linkend="win32service.constants.servicestatus">Win32Service サービスステータス定数</link></member>
</simplelist>
</para>
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-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-start-service-ctrl-dispatcher.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 305206 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346737 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">
<refnamediv>
<refname>win32_start_service_ctrl_dispatcher</refname>
@@ -15,6 +16,7 @@
<methodsynopsis>
<type>mixed</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>
<para>
@@ -36,6 +38,12 @@
をコールして返り値を適切に処理することで実現できます。
</para>
+ <caution>
+ <para>
+ 0.2.0 以降では、この関数は "cli" SAPI でのみ動作します。
+ 他の SAPI では、この関数は無効になっています。
+ </para>
+ </caution>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -50,6 +58,16 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><parameter>gracefulMode</parameter></term>
+ <listitem>
+ <para>
+ &true; の場合、graceful に終了します。
+ &false; の場合、エラーで終了します。
+ 詳細は <function>win32_set_service_exit_mode</function> を参照してください。
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</refsect1>
@@ -93,6 +111,36 @@
</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>0.4.0</entry>
+ <entry>
+ <parameter>gracefulMode</parameter> パラメータが追加されました。
+ </entry>
+ </row>
+ <row>
+ <entry>0.2.0</entry>
+ <entry>
+ この関数は <literal>"cli"</literal> SAPI でのみ動作するようになりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1><!-- }}} -->
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -99,6 +147,8 @@
<simplelist>
<member><function>win32_set_service_status</function></member>
<member><function>win32_get_last_control_message</function></member>
+ <member><function>win32_set_service_exit_mode</function></member>
+ <member><function>win32_set_service_exit_code</function></member>
<member><link linkend="win32service.constants.errors">Win32 エラーコード</link></member>
</simplelist>
</para>
Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-start-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-start-service.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-start-service.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 304597 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346737 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">
<refnamediv>
<refname>win32_start_service</refname>
@@ -16,7 +17,9 @@
</methodsynopsis>
<para>
- 指定したサービスの開始を試みます。通常は管理者権限を必要とします。
+ 指定したサービスの開始を試みます。
+ 管理者権限、
+ またはサービスのACLで適切な権限が設定されたアカウントが必要です。
</para>
</refsect1>
@@ -51,11 +54,39 @@
</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>0.3.0</entry>
+ <entry>
+ ACLが別のアカウントに設定されていた場合、
+ この関数は管理者権限を必要としなくなりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1><!-- }}} -->
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>win32_stop_service</function></member>
+ <member><function>win32_pause_service</function></member>
+ <member><function>win32_continue_service</function></member>
+ <member><function>win32_send_custom_control</function></member>
<member><link linkend="win32service.constants.errors">Win32 エラーコード</link></member>
</simplelist>
</para>
Modified: phpdoc/ja/trunk/reference/win32service/functions/win32-stop-service.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/functions/win32-stop-service.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/functions/win32-stop-service.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 308108 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 346737 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">
<refnamediv>
<refname>win32_stop_service</refname>
@@ -16,7 +17,8 @@
</methodsynopsis>
<para>
- サービスを停止します。管理者権限を必要とします。
+ サービスを停止します。管理者権限、
+ またはサービスのACLで適切な権限が設定されたアカウントが必要です。
</para>
</refsect1>
@@ -51,11 +53,39 @@
</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>0.3.0</entry>
+ <entry>
+ ACLが別のアカウントに設定されていた場合、
+ この関数は管理者権限を必要としなくなりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1><!-- }}} -->
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>win32_start_service</function></member>
+ <member><function>win32_pause_service</function></member>
+ <member><function>win32_continue_service</function></member>
+ <member><function>win32_send_custom_control</function></member>
<member><link linkend="win32service.constants.errors">Win32 エラーコード</link></member>
</simplelist>
</para>
Modified: phpdoc/ja/trunk/reference/win32service/setup.xml
===================================================================
--- phpdoc/ja/trunk/reference/win32service/setup.xml 2020-01-20 16:43:01 UTC (rev 348981)
+++ phpdoc/ja/trunk/reference/win32service/setup.xml 2020-01-20 18:18:25 UTC (rev 348982)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 304596 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 345077 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">
&reftitle.setup;
@@ -39,6 +40,28 @@
</section>
<!-- }}} -->
+ <section xml:id="win32service.security">
+ <title xmlns="http://docbook.org/ns/docbook">セキュリティの考慮</title>
+ <para>
+ この拡張モジュールでは、アクションによっては管理者権限が必要なものがあります。
+ たとえば
+ <link linkend="function.win32-create-service">create</link>,
+ <link linkend="function.win32-delete-service">delete</link>,
+ <link linkend="function.win32-start-service">start</link>,
+ <link linkend="function.win32-stop-service">stop</link>,
+ <link linkend="function.win32-pause-service">pause</link> そして
+ <link linkend="function.win32-continue-service">continue</link> です。
+ これによって、Webインターフェイスやリモートからのサービスの操作が可能な場合、
+ 権限の昇格が起きる可能性があります。
+ </para>
+ <para>
+ 現在の管理者のタスクを、非管理者またはサービスアカウントに委譲するために、
+ サービスにACLを設定できます。
+ 詳細な手順は、
+ <link xlink:href="https://support.microsoft.com/en-us/help/914392/best-practices-and-guidance-for-writers-of-service-discretionary-acces">Microsoft Knowledge Base</link> を参照してください。
+ </para>
+ </section>
+
</chapter>
<!-- Keep this comment at the end of the file