此函式會從功能名稱建構兩個 SID 陣列。 一個是具有 NT 授權單位的陣列群組 SID,另一個是具有 AppAuthority 的功能 SID 陣列。
語法
BOOL DeriveCapabilitySidsFromName(
[in] LPCWSTR CapName,
[out] PSID **CapabilityGroupSids,
[out] DWORD *CapabilityGroupSidCount,
[out] PSID **CapabilitySids,
[out] DWORD *CapabilitySidCount
);
Parameters
[in] CapName
功能名稱以字串形式呈現。
[out] CapabilityGroupSids
GroupSids 與 NTAuthority。
[out] CapabilityGroupSidCount
陣列中 GroupSid 的數量。
[out] CapabilitySids
CapabilitySids 與 AppAuthority。
[out] CapabilitySidCount
CapabilitySid 與 AppAuthority 的數量。
返回值
若函式成功,則回傳 TRUE。
如果函式失敗,則會傳回 FALSE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
呼叫者預期會透過呼叫 LocalFree釋放每個陣列中回傳的個別 SID,以及陣列本身分配的記憶體。
用於舊有能力應用能力(Win10 之前發布)計算的 SID 與已發佈的 SID 相同,但服務群組能力的 SID 將以雜湊為基礎。
要求
| 需求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP [桌面應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [桌面應用程式 |UWP 應用程式] |
| 目標平臺 | Windows 作業系統 |
| 標頭 | securitybaseapi.h (包括 Windows.h) |
| 範本庫 | OneCoreUAP.lib |
| DLL | KernelBase.dll |