Função AuthzModifyClaims (authz.h)

A função AuthzModifyClaims adiciona, exclui ou modifica declarações de usuário e dispositivo no contexto do cliente Authz.

Sintaxe

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

Um identificador para o contexto do cliente a ser modificado.

[in] ClaimClass

Tipo de informação a ser modificada. O chamador pode especificar AuthzContextInfoUserClaims ou AuthzContextInfoDeviceClaims.

[in] pClaimOperations

Um ponteiro para uma matriz de AUTHZ_SECURITY_ATTRIBUTE_OPERATION valores de enumeração que especificam o tipo de modificação de declaração a ser feita.

[in, optional] pClaims

Um ponteiro para uma estrutura AUTHZ_SECURITY_ATTRIBUTES_INFORMATION que especifica as declarações a serem modificadas.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A enumeração AUTHZ_SECURITY_ATTRIBUTE_OPERATION deverá ter apenas um elemento se o valor desse elemento for AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL. Caso contrário, a matriz terá o mesmo número de elementos que o PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION correspondente.

Se a enumeração AUTHZ_SECURITY_ATTRIBUTE_OPERATION for AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE e a função falhar, chame GetLastError. Se o código de erro for ERROR_ALREADY_EXISTS, os valores da declaração terão entradas duplicadas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	authz.h
Biblioteca	Authz.lib
DLL	Authz.dll