« win32_remove_service_env_var
win32_set_service_exit_code »

win32_send_custom_control

(PECL win32service >=0.4.0)

win32_send_custom_control — サービスにカスタムコントロールを送信する

説明

function win32_send_custom_control(string $servicename, int $control, string $machine = null): void

詳細は » Microsoft ControlService function を参照ください。

パラメータ

servicename

サービスの短縮名

control

カスタムコントロールの値。 128 から 255 までの値を取ります

machine

オプションのマシン名。 省略すると、ローカルのマシン名を使います。

戻り値

値を返しません。

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

エラー / 例外

1.0.0 よr前のバージョンでは、コントロールの値が 128 から255までの値でない場合、 E_ERROR レベルのエラーが発生していました。

servicename パラメータが空の場合は、 ValueError がスローされます。

control パラメータの値が 128 から 255 までの値でない場合、 ValueError がスローされます。

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

変更履歴

バージョン 説明
PECL win32service 1.0.0 パラメータに不正な値が含まれている場合、 ValueError がスローされます。 これより前のバージョンでは、false を返していました。
PECL win32service 1.0.0 エラー時に Win32ServiceException がスローされるようになりました。 これより前のバージョンでは Win32 Error Code を返していました。
PECL win32service 1.0.0 戻り値の型が void になりました。 これより前のバージョンでは、mixed でした。

参考

関連キーワード:
service   サービス   control   コントロール   カスタム   送信   send   custom   servicename   ValueError   machine   マシン   ServiceException   中断   remove   exit   code   詳細   Microsoft   ControlService   短縮   省略   ローカル   成功   問題
関連する関数・ページ:
function.win32-pause-service   function.win32-start-service   function.win32-stop-service   function.win32-continue-service   function.win32-delete-service   ref.win32service