array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.win32-delete-service.php', 1 => 'win32_delete_service', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'win32service 関数', ), 'prev' => array ( 0 => 'function.win32-create-service.php', 1 => 'win32_create_service', ), 'next' => array ( 0 => 'function.win32-get-last-control-message.php', 1 => 'win32_get_last_control_message', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/win32service/functions/win32-delete-service.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL win32service >=0.1.0)
win32_delete_service — SCM データベースからサービスのエントリを削除する
SCM データベースからサービスの削除を試みます。管理者権限が必要です。
この関数は、単にサービスに削除マークをつけるだけです。もし他のプロセス (サービスアプレットなど)が開かれた場合、削除処理はそのアプリケーションが 終了するまで延期されます。サービスに削除マークがつけられると、それ以降は 同じサービスに対する削除の試行は失敗します。また同名の新規サービスを作成 しようとする処理も失敗します。
servicename
サービスの短い名前。
machine
オプションのマシン名。指定しなかった場合、ローカルマシンが使用されます。
値を返しません。
バージョン 1.0.0 より前では、
成功した場合に WIN32_NO_ERROR
を返していました。パラメータに問題がある場合は false
、失敗した場合は Win32 エラーコード を返します。
バージョン | 説明 |
---|---|
PECL win32service 1.0.0 |
引数に不正な値があった場合、
ValueError をスローするようになりました。
これより前のバージョンでは、false を返していました。
|
PECL win32service 1.0.0 | エラー時に Win32ServiceException をスローするようになりました。 これより前のバージョンでは、 Win32 エラーコード を返していました。 |
PECL win32service 1.0.0 | 戻り値の型が void になりました。 これより前のバージョンでは、mixed でした。 |
例1 win32_delete_service() の例
dummyphp サービスを削除します。
<?php
win32_delete_service('dummyphp');
?>