GetServiceDisplayNameW

指定したサービスの表示名を取得する。(Unicode)

GetServiceDisplayNameW hSCManager, lpServiceName, lpDisplayName, lpcchBuffer

hSCManager : [intptr] OpenSCManager 関数によって返されるサービスコントロールマネージャデータベースへのハンドル。
lpServiceName : [wstr] サービス名。この名前はサービスのレジストリ キー名と同じである。256 文字未満の名前を選択することが推奨される。
lpDisplayName : [wstr] サービスの表示名を受け取るバッファへのポインタ。関数が失敗した場合、このバッファには空文字列が格納される。この配列の最大サイズは 4K バイトである。必要なサイズを判別するには、このパラメータに NULL を、lpcchBuffer パラメータに 0 を指定する。関数は失敗し、GetLastError は ERROR_INSUFFICIENT_BUFFER を返す。lpcchBuffer パラメータは必要なサイズを受け取る。このパラメータは次の形式でローカライズされた文字列を指定できる: @[path\]dllname,-strID 識別子 strID の文字列は dllname から読み込まれ、path は任意である。詳細は RegLoadMUIString を参照。Windows Server 2003 および Windows XP: ローカライズされた文字列は Windows Vista までサポートされていない。
lpcchBuffer : [var] lpDisplayName が指すバッファのサイズを TCHAR 単位で指定する変数へのポインタ。

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

解説

指定したサービスの表示名を取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値はゼロ以外となる。失敗した場合、戻り値はゼロとなる。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
サービスには 2 つの名前がある。サービス名と表示名である。サービス名はレジストリ内のサービスのキーの名前である。表示名は
Services コントロール パネル アプリケーションに表示されるユーザーフレンドリな名前であり、NET START
コマンドで使用される。サービス名を表示名にマップするには GetServiceDisplayName
関数を使用する。表示名をサービス名にマップするには GetServiceKeyName 関数を使用する。
> [!NOTE] > winsvc.h ヘッダーは GetServiceDisplayName
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode
版を自動的に選択する。エンコーディングに依存しないエイリアスと、エンコーディングに依存しないコードとを混在させると、コンパイルエラーや実行時エラーを引き起こす不整合が生じる可能性がある。詳細は
[関数プロトタイプの規約](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報