estructura de AUTHZ_ACCESS_REPLY (authz.h)

  • Artículo

La estructura AUTHZ_ACCESS_REPLY define una respuesta de comprobación de acceso.

Sintaxis

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

Miembros

ResultListLength

Número de elementos de las matrices GrantedAccessMask, SaclEvaluationResults y Error . Este número coincide con el número de entradas de la estructura de lista de tipos de objeto usada en la comprobación de acceso. Si no se usa ningún tipo de objeto para representar el objeto, establezca ResultListLength en uno.

GrantedAccessMask

Matriz de máscaras de acceso concedidas. La aplicación asigna memoria para esta matriz antes de llamar a AccessCheck.

SaclEvaluationResults

Matriz de resultados de evaluación de la lista de control de acceso del sistema (SACL). La aplicación asigna memoria para esta matriz antes de llamar a AccessCheck. La evaluación sacl solo se realizará si se solicita la auditoría. Cada elemento de este miembro puede ser uno de los siguientes valores.

Valor Significado
AUTHZ_GENERATE_SUCCESS_AUDIT
0x1
 Se generó un mensaje de auditoría que indica que se ha generado correctamente.
AUTHZ_GENERATE_FAILURE_AUDIT
0x2
 Mensaje de auditoría que indica que se generó un error.

Error

Matriz de resultados para cada elemento de la matriz. La aplicación asigna memoria para esta matriz antes de llamar a AccessCheck.

En la tabla siguiente se enumeran los valores de error posibles.

Valor Significado
ERROR_SUCCESS
 Se conceden todos los bits de acceso, no incluidos MAXIMUM_ALLOWED, y el miembro GrantedAccessMask no es cero.
ERROR_PRIVILEGE_NOT_HELD
 DesiredAccess incluye ACCESS_SYSTEM_SECURITY y el cliente no tiene SeSecurityPrivilege.
ERROR_ACCESS_DENIED
 Incluye cada una de las siguientes opciones:
  • No se conceden los bits solicitados.
  • El bit MaximumAllowed está activado y el acceso concedido es cero.
  • DesiredAccess es cero.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado authz.h
Redistribuible Paquete de herramientas de administración de Windows Server 2003 en Windows XP

Consulte también

AccessCheck