RtlInitializeSidEx 函数 (ntifs.h)

RtlInitializeSidEx 例程初始化预分配的安全标识符 (SID) 结构。

语法

NTSYSAPI NTSTATUS RtlInitializeSidEx(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY IdentifierAuthority,
  [in]  UCHAR                     SubAuthorityCount,
        ...                       
);

参数

[out] Sid

指向要初始化的调用方分配的 SID 结构的指针。

[in] IdentifierAuthority

指向在 SID 结构中设置 的SID_IDENTIFIER_AUTHORITY 结构的指针。

[in] SubAuthorityCount

在 SID 中设置的子机构数。

...

要设置每个子机构的值。 调用方必须指定 SubAuthorityCount 参数。

返回值

RtlInitializeSid 返回下列值之一:

返回代码 说明
STATUS_SUCCESS
已成功初始化 SID。
STATUS_INVALID_PARAMETER
指定的 SubAuthorityCount 值无效。

注解

有关安全性和访问控制的详细信息,请参阅 面向驱动程序开发人员的 Windows 安全模型 以及 Windows SDK 中有关这些主题的文档。

要求

要求
最低受支持的客户端 Windows 10
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY