EnumServicesStatusExW

指定したサービスコントロールマネージャデータベース内のサービスを列挙する。各サービスの名前と状態が提供されるとともに、指定した情報レベルに基づく追加データが提供される。(Unicode)

EnumServicesStatusExW hSCManager, InfoLevel, dwServiceType, dwServiceState, lpServices, cbBufSize, pcbBytesNeeded, lpServicesReturned, lpResumeHandle, pszGroupName

hSCManager : [intptr] サービスコントロールマネージャデータベースへのハンドル。このハンドルは OpenSCManager 関数によって返され、SC_MANAGER_ENUMERATE_SERVICE アクセス権を持っている必要がある。詳細は Service Security and Access Rights を参照。
InfoLevel : [int] 返されるサービス属性。データベース内の各サービスの名前とサービス状態情報を取得するには SC_ENUM_PROCESS_INFO を使用する。lpServices パラメータは ENUM_SERVICE_STATUS_PROCESS 構造体の配列を受け取るバッファへのポインタである。バッファは構造体と、それらのメンバが指す文字列を格納するのに十分な大きさでなければならない。現在、他の情報レベルは定義されていない。
dwServiceType : [int] 
dwServiceState : [int] 
lpServices : [var] 状態情報を受け取るバッファへのポインタ。このデータの形式は InfoLevel パラメータの値によって異なる。この配列の最大サイズは 256K バイトである。必要なサイズを判別するには、このパラメータに NULL を、cbBufSize パラメータに 0 を指定する。関数は失敗し、GetLastError は ERROR_MORE_DATA を返す。pcbBytesNeeded パラメータが必要なサイズを受け取る。Windows Server 2003 および Windows XP: この配列の最大サイズは 64K バイトである。この制限は Windows Server 2003 with SP1 および Windows XP with SP2 以降で引き上げられた。
cbBufSize : [int] lpServices パラメータが指すバッファのサイズ (バイト単位)。
pcbBytesNeeded : [var] バッファが小さすぎる場合、残りのサービスエントリを返すために必要なバイト数を受け取る変数へのポインタ。
lpServicesReturned : [var] 返されたサービスエントリの数を受け取る変数へのポインタ。
lpResumeHandle : [var] 入力時に列挙の開始点を指定する変数へのポインタ。EnumServicesStatusEx 関数を初めて呼び出すときにはこの値をゼロに設定しなければならない。出力時、関数が成功した場合この値はゼロとなる。ただし、関数が 0 を返し、GetLastError 関数が ERROR_MORE_DATA を返した場合、この値は EnumServicesStatusEx 関数が追加データを取得するために呼び出されるときに次に読み取るサービスエントリを示す。
pszGroupName : [wstr] 読み込み順グループ名。このパラメータが文字列の場合、列挙されるのは文字列で指定された名前のグループに属するサービスのみとなる。このパラメータが空文字列の場合、どのグループにも属さないサービスだけが列挙される。このパラメータが NULL の場合、グループのメンバシップは無視され、すべてのサービスが列挙される。

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

解説

指定したサービスコントロールマネージャデータベース内のサービスを列挙する。各サービスの名前と状態が提供されるとともに、指定した情報レベルに基づく追加データが提供される。(Unicode)

[戻り値]
関数が成功した場合、戻り値はゼロ以外となる。失敗した場合、戻り値はゼロとなる。拡張エラー情報を取得するには GetLastError
を呼び出す。以下のエラーが返される可能性がある。
（以下省略）

[備考]
呼び出し側がサービスに対する SERVICE_QUERY_STATUS
アクセス権を持っていない場合、そのサービスはクライアントに返されるサービス一覧から静かに省略される。
> [!NOTE] > winsvc.h ヘッダーは EnumServicesStatusEx
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode
版を自動的に選択する。エンコーディングに依存しないエイリアスと、エンコーディングに依存しないコードとを混在させると、コンパイルエラーや実行時エラーを引き起こす不整合が生じる可能性がある。詳細は
[関数プロトタイプの規約](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報