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 (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL < DISPATCH_LEVEL

另请参阅

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY