GetSidSubAuthorityCount 函式 (securitybaseapi.h)

GetSidSubAuthorityCount 函式會傳回安全性標識符中成員的指標, (SID) 結構,其中包含子授權計數。

語法

PUCHAR GetSidSubAuthorityCount(
  [in] PSID pSid
);

參數

[in] pSid

從中傳回子授權計數指標的 SID 結構指標。

此函式不會處理無效 的 SID 結構。 呼叫 IsValidSid 函式,以確認 SID 結構在您呼叫此函式之前是否有效。

傳回值

如果函式成功,則傳回值是指定 SID 結構的子授權計數指標。

如果函式失敗,則傳回值未定義。 如果指定的 SID 結構無效,函式就會失敗。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

pSid 中指定的 SID 結構會使用 32 位值。 對於需要較長 RID 值的應用程式,請使用 CreateWellKnownSid 和相關函式。

規格需求

需求
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 securitybaseapi.h (包括 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

存取控制 概觀

基本 存取控制 函式

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

IsValidSid

SID