DeriveCapabilitySidsFromName function (securitybaseapi.h)

此函式會從功能名稱建構兩個 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