共用方式為


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 會傳回下列其中一項:

傳回碼 Description
STATUS_SUCCESS
已成功初始化 SID。
STATUS_INVALID_PARAMETER
指定的 SubAuthorityCount 值無效。

備註

雖然 RtlInitializeSid 會設定 SID 的子授權數目,但不會設定子授權值。 這必須藉由呼叫 RtlSubAuthoritySid 來個別完成。

如需安全性和訪問控制的詳細資訊,請參閱 適用於驅動程序開發人員的 Windows 安全性模型 ,以及 Windows SDK 中這些主題的相關文件。

規格需求

需求
最低支援的用戶端 Windows 2000
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式)
IRQL < DISPATCH_LEVEL

另請參閱

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY