RtlInitializeSid 函数 (ntifs.h)

RtlInitializeSid 例程初始化安全标识符 (SID) 结构。

语法

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

参数

[out] Sid

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

[in] IdentifierAuthority

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

[in] SubAuthorityCount

在 SID 中设置的子授权数。 必须单独设置子授权值,如以下“备注”部分所述。

返回值

RtlInitializeSid 返回以下项之一:

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

言论

尽管 RtlInitializeSid 设置 SID 的子授权数,但它不设置子授权值。 必须通过调用 RtlSubAuthoritySid单独执行此作。

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

要求

要求 价值
最低支持的客户端 Windows 2000
目标平台 普遍
标头 ntifs.h (include Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe(内核模式):Ntdll.dll(用户模式)
IRQL < DISPATCH_LEVEL

另请参阅

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY