共用方式為


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

另請參閱

存取控制 概觀

AllocateAndInitializeSid

基本 存取控制 函式

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY