LookupPrivilegeDisplayNameW

指定された特権を表す表示名を取得する。(Unicode)

LookupPrivilegeDisplayNameW lpSystemName, lpName, lpDisplayName, cchDisplayName, lpLanguageId

lpSystemName : [wstr] 特権名が取得されるシステムの名前を指定する null 終端文字列へのポインタ。null 文字列が指定された場合、関数はローカルシステムで表示名を見つけようとする。
lpName : [wstr] Winnt.h で定義されている特権名を指定する null 終端文字列へのポインタ。例えば、このパラメータは定数 SE_REMOTE_SHUTDOWN_NAME、またはそれに対応する文字列 "SeRemoteShutdownPrivilege" を指定できる。値のリストについては Privilege Constants を参照。
lpDisplayName : [wstr] 特権表示名を指定する null 終端文字列を受け取るバッファへのポインタ。例えば、lpName パラメータが SE_REMOTE_SHUTDOWN_NAME の場合、特権表示名は "Force shutdown from a remote system." となる。
cchDisplayName : [var] lpDisplayName バッファのサイズを TCHAR 単位で指定する変数へのポインタ。関数が戻るとき、このパラメータには終端 null 文字を含まない特権表示名の長さが格納される。lpDisplayName パラメータが指すバッファが小さすぎる場合、この変数には必要なサイズが格納される。
lpLanguageId : [var] 返された表示名の言語識別子を受け取る変数へのポインタ。

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

解説

指定された特権を表す表示名を取得する。(Unicode)

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

[備考]
LookupPrivilegeDisplayName 関数は、Winnt.h の Defined Privileges
セクションで指定された特権の表示名のみを取得する。
> [!NOTE] > winbase.h ヘッダーは LookupPrivilegeDisplayName
をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode
版を自動的に選択する。詳細は [Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報