Share via


getSidIdentifierAuthority 函式 (securitybaseapi.h)

GetSidIdentifierAuthority 函式會傳回指定安全性標識碼中SID_IDENTIFIER_AUTHORITY結構的指標, (SID) 。

語法

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  [in] PSID pSid
);

參數

[in] pSid

傳回SID_IDENTIFIER_AUTHORITY結構指標之 SID 結構的指標。

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

傳回值

如果函式成功,傳回值是指定 SID 結構的SID_IDENTIFIER_AUTHORITY結構的指標。

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

備註

此函式使用32位 RID 值。 對於需要較大 RID 值的應用程式,請使用 CreateWellKnownSid 和相關函式。

規格需求

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

另請參閱

存取控制 概觀

基本 存取控制 函式

CreateWellKnownSid

GetLengthSid

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY