EnumDependentServicesW

指定したサービスに依存する各サービスの名前と状態を取得する。(Unicode)

EnumDependentServicesW hService, dwServiceState, lpServices, cbBufSize, pcbBytesNeeded, lpServicesReturned

hService : [intptr] サービスへのハンドル。このハンドルは OpenService または CreateService 関数によって返され、SERVICE_ENUMERATE_DEPENDENTS アクセス権を持っている必要がある。詳細は Service Security and Access Rights を参照。
dwServiceState : [int] 
lpServices : [var] データベース内の各依存サービスの名前とサービス状態情報を受け取る ENUM_SERVICE_STATUS 構造体の配列へのポインタ。バッファは構造体とそれらのメンバが指す文字列を格納するのに十分な大きさでなければならない。配列内のサービスの順序は、サービスの開始順の逆順となる。つまり、配列の最初のサービスは最後に開始されるもので、最後のサービスは最初に開始されるものである。この配列の最大サイズは 64,000 バイトである。必要なサイズを判別するには、このパラメータに NULL を、cbBufSize パラメータに 0 を指定する。関数は失敗し、GetLastError は ERROR_MORE_DATA を返す。pcbBytesNeeded パラメータが必要なサイズを受け取る。
cbBufSize : [int] lpServices パラメータが指すバッファのサイズ (バイト単位)。
pcbBytesNeeded : [var] サービスエントリの配列を格納するのに必要なバイト数を受け取る変数へのポインタ。変数がこの値を受け取るのは、lpServices が指すバッファが小さすぎる場合 (関数の失敗と ERROR_MORE_DATA エラーで示される) のみである。そうでない場合、pcbBytesNeeded の内容は未定義である。
lpServicesReturned : [var] 返されたサービスエントリの数を受け取る変数へのポインタ。

(プラグイン / モジュール : advapi32.dll)

解説

指定したサービスに依存する各サービスの名前と状態を取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値はゼロ以外となる。失敗した場合、戻り値はゼロとなる。拡張エラー情報を取得するには GetLastError
を呼び出す。以下のエラーコードはサービスコントロールマネージャによって設定される可能性がある。他のエラーコードは、サービスコントロールマネージャが呼び出すレジストリ関数によって設定される可能性がある。
（以下省略）

[備考]
返されるサービス
エントリは、グループ順序を考慮した開始順の逆順で並べられている。依存サービスを停止する必要がある場合、lpServices
バッファに書き込まれたエントリの順序を使用して、依存サービスを適切な順序で停止できる。

情報