Función AuthzModifyClaims (authz.h)

La función AuthzModifyClaims agrega, elimina o modifica las notificaciones de usuario y dispositivo en el contexto del cliente de Authz.

Sintaxis

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
);

Parámetros

[in] hAuthzClientContext

Identificador del contexto de cliente que se va a modificar.

[in] ClaimClass

Tipo de información que se va a modificar. El autor de la llamada puede especificar AuthzContextInfoUserClaims o AuthzContextInfoDeviceClaims.

[in] pClaimOperations

Puntero a una matriz de valores de enumeración AUTHZ_SECURITY_ATTRIBUTE_OPERATION que especifican el tipo de modificación de notificación que se va a realizar.

[in, optional] pClaims

Puntero a una estructura AUTHZ_SECURITY_ATTRIBUTES_INFORMATION que especifica las notificaciones que se van a modificar.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La enumeración AUTHZ_SECURITY_ATTRIBUTE_OPERATION debe tener solo un elemento si el valor de ese elemento es AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL. De lo contrario, la matriz tiene el mismo número de elementos que el PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION correspondiente.

Si la enumeración AUTHZ_SECURITY_ATTRIBUTE_OPERATION es AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE y se produce un error en la función, llame a GetLastError. Si el código de error es ERROR_ALREADY_EXISTS, los valores de la notificación tienen entradas duplicadas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	authz.h
Library	Authz.lib
Archivo DLL	Authz.dll