Función AuditQuerySecurity (ntsecapi.h)

La función AuditQuerySecurity recupera el descriptor de seguridad que delega el acceso a la directiva de auditoría.

Sintaxis

BOOLEAN AuditQuerySecurity(
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor
);

Parámetros

[in] SecurityInformation

Valor SECURITY_INFORMATION que especifica qué partes del descriptor de seguridad establece esta función. Solo se admiten SACL_SECURITY_INFORMATION y DACL_SECURITY_INFORMATION . Se omite cualquier otro valor. Si no se especifica ni SACL_SECURITY_INFORMATIONni DACL_SECURITY_INFORMATION , se produce un error en esta función y se devuelve ERROR_INVALID_PARAMETER.

[out] ppSecurityDescriptor

Dirección de un puntero a una estructura de SECURITY_DESCRIPTOR bien formada que controla el acceso al objeto de seguridad Audit.

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. GetLastError puede devolver uno de los siguientes códigos de error definidos en WinError.h.

Código o valor devuelto	Descripción
ERROR_ACCESS_DENIED 5	El autor de la llamada no tiene los derechos de privilegio o acceso necesarios para llamar a esta función.
ERROR_INVALID_PARAMETER 87	Uno o varios parámetros no son válidos.

Comentarios

Para llamar correctamente a esta función, el autor de la llamada debe tener SeSecurityPrivilege.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntsecapi.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll

Consulte también

AuditSetSecurity