InitializeSid 函式 (securitybaseapi.h)
InitializeSid 函式會在 SID) (初始化安全性識別碼。
語法
BOOL InitializeSid(
[out] PSID Sid,
[in] PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
[in] BYTE nSubAuthorityCount
);
參數
[out] Sid
要初始化 之 SID 結構的指標。
[in] pIdentifierAuthority
要設定於 SID 結構中的SID_IDENTIFIER_AUTHORITY結構的指標。
[in] nSubAuthorityCount
指定要在 SID 中設定的子授權數目。 子授權的值必須個別設定，如下列一節所述。
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
雖然 InitializeSid 函式會設定 SID 的子授權數目，但它不會設定子授權值。 這必須個別完成，使用 GetSidSubAuthority 之類的函式。
應用程式可以使用 AllocateAndInitializeSid 函式來初始化 SID 並設定其子授權值。
此函式使用32位 RID 值。 對於需要較大 RID 值的應用程式，請使用 CreateWellKnownSid。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | securitybaseapi.h (包括 Windows.h) |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |