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 |