QueryServiceStatus

Declare Function Api_QueryServiceStatus& Lib "advapi32" Alias "QueryServiceStatus" (ByVal hService&, lpServiceStatus As SERVICE_STATUS)

Declare Function QueryServiceStatus Lib "advapi32" Alias "QueryServiceStatus" (ByVal hService As Long, lpServiceStatus As SERVICE_STATUS) As Long

パラメータ
hService
    ［入力］サービスのハンドルを指定する。OpenService 関数または CreateService 関数が返したハンドルを指定し、これには

    SERVICE_QUERY_STATUS アクセス権が必要である。
lpServiceStatus
    ［出力］ステータス情報を受け取る 構造体へのポインタを指定する。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、 関数を使う。
    サービス制御マネージャは次のエラーコードを設定することがある。サービス制御マネージャが呼び出したレジストリ関数は、その他のエラー

    コードを設定することがある。

エラーコード	意味
ERROR_ACCESS_DENIED	指定されたハンドルを開く際に、SERVICE_QUERY_STATUS アクセス権が指定されていなかった。
ERROR_INVALID_HANDLE	指定されたハンドルは無効である。

解説
    QueryServiceStatus 関数は、サービス制御マネージャへ報告された、サービスの最新ステータス情報を取得する。サービスがステータスを

    変更した直後は、サービス制御マネージャの保持する情報がまだ更新されていない可能性がある。アプリケーションは

    SERVICE_CONTROL_INTERROGATE 制御コードを指定して ControlService 関数を呼び出すことにより、サービスを直接検討し、サー

    ビスの現在のステータスを把握することもできる。