Share via

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 (0x00000000L) 。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winternl.h
Library ntdll.lib
DLL ntdll.dll