getSidSubAuthority 函式 (securitybaseapi.h)

GetSidSubAuthority 函式會傳回安全性標識碼中指定子授權的指標， (SID) 。子授權值是 RID) (相對識別碼。

語法

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

[in] pSid

SID 結構的指標，要從中傳回子授權的指標。

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

[in] nSubAuthority

指定索引值，識別函式將傳回其位址的子授權數位專案。函式不會對此值執行任何驗證測試。應用程式可以呼叫 GetSidSubAuthorityCount 函式來探索可接受的值範圍。

如果函式成功，則傳回值是指定之 SID 子授權的指標。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

如果函式失敗，則傳回值是未定義的。如果指定的 SID 結構無效，或 nSubAuthority 參數所指定的索引值超出界限，則函式會失敗。

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

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