LsaGetAppliedCAPIDs 函数 (ntlsa.h)

LsaGetAppliedCAPIDs 函数返回中央访问策略数组, (CAP) 标识符 (CAPID,) 特定计算机上应用的所有 CAP。

语法

NTSTATUS LsaGetAppliedCAPIDs(
  [in, optional] PLSA_UNICODE_STRING SystemName,
  [out]          PSID                **CAPIDs,
  [out]          PULONG              CAPIDCount
);

参数

[in, optional] SystemName

指向包含特定计算机名称 的 LSA_UNICODE_STRING 结构的指针。 该名称的格式可以是“ComputerName”或“\ComputerName”。 如果此参数为 NULL,则该函数将返回本地计算机的 CAPID。

[out] CAPIDs

指向变量的指针,该变量接收指向 CAPID 的指针数组,这些 CAPID 标识指定计算机上可用的 CAP。 使用完 CAPID 后,对数组中的每个元素和整个数组调用 LsaFreeMemory 函数。

[out] CAPIDCount

指向变量的指针,该变量接收指定计算机上可用的 CAP 数。 CAPIDs 参数中返回的数组包含与 CAPIDCount 参数相同的元素数。

返回值

如果函数成功,则返回值STATUS_SUCCESS。

如果函数失败,则返回值为 LSA 策略函数返回值之一。 可以使用 LsaNtStatusToWinError 函数将 NTSTATUS 代码转换为 Windows 错误代码。

注解

有关中央访问策略的具体详细信息,可以在指定计算机的域控制器上的 Active Directory 中查询中央访问策略对象的属性。 查找 其 msAuthz-CentralAccessPolicyID 属性与返回的 CAPID 之一匹配的对象。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 ntlsa.h
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

集中式授权策略