派生CapabilitySidsFromName 函数 (securitybaseapi.h)

此函数使用功能名称构造两个 SID 数组。 一个是具有 NT Authority 的数组组 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

CapabilitySids with AppAuthority。

[out] CapabilitySidCount

AppAuthority 的 CapabilitySid 计数。

返回值

如果该函数成功,则返回 TRUE

如果函数失败,则返回 FALSE。 要获得更多的错误信息,请调用 GetLastError。

注解

调用方应通过调用 LocalFree释放每个数组中返回的单个 SID,以及为数组本身分配的内存。

为在 Win10 () 之前发布的旧版功能的应用程序功能计算的 SID 将与已发布的 SID 相同,但服务组功能 SID 的 SID 将基于哈希。

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 securitybaseapi.h (包括 Windows.h)
Library Advapi32.lib
DLL Kernel32.dll