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 |