RtlConvertSidToUnicodeString 関数 (winternl.h)

[ RtlConvertSidToUnicodeString 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 ConvertSidToStringSid 関数を 使用します。

RtlConvertSidToUnicodeString 関数は、セキュリティ識別子 (SID) を Unicode 文字表現に変換します。 この関数には、インポート ライブラリが関連付けされません。 LoadLibrary 関数と GetProcAddress 関数を使用して、Ntdll.dll に動的にリンクする必要があります。

構文

NTSTATUS RtlConvertSidToUnicodeString(
  [out] PUNICODE_STRING UnicodeString,
  [in]  PSID            Sid,
  [in]  BOOLEAN         AllocateDestinationString
);

パラメーター

[out] UnicodeString

セキュリティ識別子の Unicode 文字表現へのポインター。

[in] Sid

セキュリティ識別子を表す SID 構造体へのポインター。

[in] AllocateDestinationString

TRUE の場合、UnicodeString は呼び出し元に代わって割り当てられ、RtlFreeUnicodeString 関数を呼び出して割り当てられたメモリを解放するのは呼び出し元の責任です。 FALSE の場合、呼び出し元は UnicodeString の割り当てと解放を担当します。

戻り値

戻り値は NTSTATUS コードです。 関数が成功すると、STATUS_SUCCESS (0x000000000L) の値が返されます。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	winternl.h
Library	ntdll.lib
[DLL]	ntdll.dll