AuthzModifyClaims 函数 (authz.h)

AuthzModifyClaims 函数在 Authz 客户端上下文中添加、删除或修改用户和设备声明。

语法

AUTHZAPI BOOL AuthzModifyClaims(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE            hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS        ClaimClass,
  [in]           PAUTHZ_SECURITY_ATTRIBUTE_OPERATION    pClaimOperations,
  [in, optional] PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION pClaims
);

参数

[in] hAuthzClientContext

要修改的客户端上下文的句柄。

[in] ClaimClass

要修改的信息的类型。 调用方可以指定 AuthzContextInfoUserClaims 或 AuthzContextInfoDeviceClaims。

[in] pClaimOperations

指向 AUTHZ_SECURITY_ATTRIBUTE_OPERATION 枚举值的数组的指针，这些值指定要进行声明修改的类型。

[in, optional] pClaims

指向 AUTHZ_SECURITY_ATTRIBUTES_INFORMATION 结构的指针，该结构指定要修改的声明。

返回值

如果该函数成功，则返回 TRUE。

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

注解

如果 AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL 该元素的值，则AUTHZ_SECURITY_ATTRIBUTE_OPERATION枚举必须只有一个元素。 否则，数组的元素数与相应的PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION相同。

如果 AUTHZ_SECURITY_ATTRIBUTE_OPERATION 枚举AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE且函数失败，请调用 GetLastError。 如果错误代码ERROR_ALREADY_EXISTS，则声明的值具有重复的条目。

要求

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