estrutura AUTHZ_ACCESS_REPLY (authz.h)

A estrutura AUTHZ_ACCESS_REPLY define um acesso marcar resposta.

Sintaxe

typedef struct _AUTHZ_ACCESS_REPLY {
  DWORD        ResultListLength;
  PACCESS_MASK GrantedAccessMask;
  PDWORD       SaclEvaluationResults;
  PDWORD       Error;
} AUTHZ_ACCESS_REPLY, *PAUTHZ_ACCESS_REPLY;

Membros

ResultListLength

O número de elementos nas matrizes GrantedAccessMask, SaclEvaluationResults e Error . Esse número corresponde ao número de entradas na estrutura de lista de tipos de objeto usada no marcar de acesso. Se nenhum tipo de objeto for usado para representar o objeto, defina ResultListLength como um.

GrantedAccessMask

Uma matriz de máscaras de acesso concedidas. A memória dessa matriz é alocada pelo aplicativo antes de chamar o AccessCheck.

SaclEvaluationResults

Uma matriz de resultados de avaliação da SACL ( lista de controle de acesso do sistema ). A memória dessa matriz é alocada pelo aplicativo antes de chamar o AccessCheck. A avaliação de SACL só será executada se a auditoria for solicitada. Cada elemento desse membro pode ser um dos valores a seguir.

Valor Significado
AUTHZ_GENERATE_SUCCESS_AUDIT
0x1
Uma mensagem de auditoria que indica que o êxito foi gerado.
AUTHZ_GENERATE_FAILURE_AUDIT
0x2
Uma mensagem de auditoria que indica que a falha foi gerada.

Error

Uma matriz de resultados para cada elemento da matriz. A memória dessa matriz é alocada pelo aplicativo antes de chamar o AccessCheck.

A tabela a seguir lista os valores de erro possíveis.

Valor Significado
ERROR_SUCCESS
Todos os bits de acesso, sem incluir MAXIMUM_ALLOWED, são concedidos e o membro GrantedAccessMask não é zero.
ERROR_PRIVILEGE_NOT_HELD
DesiredAccess inclui ACCESS_SYSTEM_SECURITY e o cliente não tem SeSecurityPrivilege.
ERROR_ACCESS_DENIED
Inclui cada um dos seguintes:
  • Os bits solicitados não são concedidos.
  • MaximumAllowed bit está ativado e o acesso concedido é zero.
  • DesiredAccess é zero.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho authz.h
Redistribuível Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP

Confira também

AccessCheck