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 |
---|---|
|
已成功初始化 SID。 |
|
指定的 SubAuthorityCount 值無效。 |
備註
雖然 RtlInitializeSid 會設定 SID 的子授權數目,但不會設定子授權值。 這必須藉由呼叫 RtlSubAuthoritySid 來個別完成。
如需安全性和訪問控制的詳細資訊,請參閱 適用於驅動程序開發人員的 Windows 安全性模型 ,以及 Windows SDK 中這些主題的相關文件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 |
目標平台 | Universal |
標頭 | ntifs.h (包含 Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式) |
IRQL | < DISPATCH_LEVEL |