win32_pause_service

サービスを中断する

説明

void win32_pause_service(string $servicename, string $machine = null)

指定した名前のサービスを中断します。 管理者権限、 またはサービスのACLで適切な権限が設定されたアカウントが必要です。

パラメータ

servicename

サービスの短い名前。

machine

マシン名。省略可能で、省略した場合はローカルマシンを使います。

戻り値

値を返しません。

バージョン 1.0.0 より前では、 成功した場合に WIN32_NO_ERROR を返していました。パラメータに問題がある場合は false、失敗した場合は Win32 エラーコード を返します。

エラー / 例外

servicename 引数が空の場合、 ValueError がスローされます。

エラー時には Win32ServiceException がスローされます。

変更履歴

バージョン 説明
PECL win32service 1.0.0 引数に不正な値があった場合、 ValueError をスローするようになりました。 これより前のバージョンでは、false を返していました。
PECL win32service 1.0.0 エラー時に Win32ServiceException をスローするようになりました。 これより前のバージョンでは、 Win32 エラーコード を返していました。
PECL win32service 1.0.0 戻り値の型が void になりました。 これより前のバージョンでは、mixed でした。
PECL win32service 0.3.0 ACLが別のアカウントに設定されていた場合、 この関数には管理者権限が不要になりました。

参考