Last updated: Fri, 10 Oct 2008

win32_create_service

(No version information available, might be only in CVS)

win32_create_service — SCM データベースに新しいサービスのエントリを作成する

説明

mixed win32_create_service ( array $details [, string $machine ] )

パラメータ

details

サービスの詳細情報を含む配列。

service: サービスの短い名前。net コマンドでサービスを制御する際に、この名前を使用します。この名前は一意である（同名のサービスが 2 つ存在することがない）必要があり、スペースを含む名前は可能な限り避けるべきです。
display: サービスの表示名。これは、サービスアプレットに表示される名前です。
user: サービスを実行するユーザ名。指定しなかった場合、サービスは LocalSystem アカウントで実行されます。ユーザ名が指定された場合、 password も指定する必要があります。
password: user に対応するパスワード。
path: サービスの開始時に起動される実行モジュールのフルパス。指定しなかった場合、現在の PHP プロセスへのパスが使用されます。
params: サービスの開始時に渡されるコマンドラインパラメータ。 PHP スクリプトをサービスとして実行したい場合は、最初のパラメータは実行するスクリプトへのフルパスとなります。
load_order: load_order を制御します。現時点では完全にはサポートされていません。
svc_type: サービスの型を指定します。指定しなかった場合、デフォルト値は WIN32_SERVICE_WIN32_OWN_PROCESS です。よくわからない場合はこの値を変更しないでください。
start_type: サービスをどのように開始させるかを指定します。デフォルトは WIN32_SERVICE_AUTO_START で、これはマシンの起動時にサービスを開始させることを意味します。
error_control: サービスに問題が発生した際にとるべき行動を SCM に指示します。デフォルトは WIN32_SERVER_ERROR_IGNORE です。この値を変更することは、現時点では完全にはサポートされていません。

machine

オプションで、サービスを作成したいマシン名を指定します。指定しなかった場合は、ローカルマシンを使用します。

返り値

成功した場合に TRUE 、それ以外の場合に win32 エラーコードを返します。

例

例1 win32_create_service() の例


<?php
$x = win32_create_service(array(
        'service' => 'dummyphp',
        'display' => 'sample dummy PHP service',
        'params' => __FILE__ . ' run',
));
debug_zval_dump($x);
?>

参考

win32_delete_service()

add a note User Contributed Notes
win32_create_service

pauljamesthomson at gmail dot com
22-Jan-2007 04:54


Other start_type values:



0x00000002: A service started automatically by the service control manager during system startup. For more information, see Automatically Starting Services.



0x00000000: A device driver started by the system loader. This value is valid only for driver services.



0x00000003: A service started by the service control manager when a process calls the win32_start_service() function.



0x00000004: A service that cannot be started. Attempts to start the service result in the error code 



0x00000001: A device driver started by the IoInitSystem function. This value is valid only for driver services.



I can confirm that 0x00000003 works as expected (service is created, but must be started manually).



More here:



http://msdn2.microsoft.com/en-us/library/ms682450.aspx

add a note

win32_delete_service

win32service 関数

Last updated: Fri, 10 Oct 2008