ConvertStringSidToSidW

文字列形式のセキュリティ識別子 (SID) を、有効で機能的な SID に変換する。本関数を使用して、ConvertSidToStringSid 関数で文字列形式に変換された SID を取得できる。(Unicode)

ConvertStringSidToSidW StringSid, Sid

StringSid : [wstr] 変換する文字列形式の SID を含む null 終端文字列へのポインタ。
Sid : [var] 変換された SID へのポインタを受け取る変数へのポインタ。返されたバッファを解放するには LocalFree 関数を呼び出す。

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

解説

文字列形式のセキュリティ識別子 (SID) を、有効で機能的な SID
に変換する。本関数を使用して、ConvertSidToStringSid 関数で文字列形式に変換された SID
を取得できる。(Unicode)

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

[備考]
> [!NOTE] > sddl.h ヘッダは、ConvertStringSidToSid を UNICODE
プリプロセッサ定数の定義に基づいて ANSI 版または Unicode
版を自動選択するエイリアスとして定義している。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーを引き起こす不一致が生じる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報