InitializeSid 函式 (securitybaseapi.h)

發行項
03/01/2024

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