DeriveCapabilitySidsFromName 函式 (securitybaseapi.h)

此函式會從功能名稱建構兩個 SID 陣列。 其中一個是具有NT授權單位的數位群組 SID，另一個則是具有AppAuthority的功能 SID 陣組。

語法

BOOL DeriveCapabilitySidsFromName(
  [in]  LPCWSTR CapName,
  [out] PSID    **CapabilityGroupSids,
  [out] DWORD   *CapabilityGroupSidCount,
  [out] PSID    **CapabilitySids,
  [out] DWORD   *CapabilitySidCount
);

參數

[in] CapName

字串格式之功能的名稱。

[out] CapabilityGroupSids

具有 NTAuthority 的 GroupSids。

[out] CapabilityGroupSidCount

陣列中的 GroupSids 計數。

[out] CapabilitySids

具有 AppAuthority 的 CapabilitySids。

[out] CapabilitySidCount

具有 AppAuthority 的 CapabilitySid 計數。

傳回值

如果函式成功，則會傳回 TRUE。

如果函式失敗，則會傳回 FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

呼叫端預期會呼叫 LocalFree來釋放每個數位中傳回的個別 SID，以及配置給數位本身的記憶體。

針對在 Win10 之前發行之舊版功能的應用程式功能 (所計算的 SID) 會與已發佈的 SID 相同，但服務群組功能的 SID 會以哈希為基礎。

規格需求

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