Función AuthzInitializeObjectAccessAuditEvent (authz.h)

  • Artículo

La función AuthzInitializeObjectAccessAuditEvent inicializa la auditoría de un objeto.

Sintaxis

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

Parámetros

[in] Flags

Modifica la auditoría. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
AUTHZ_NO_SUCCESS_AUDIT
 Deshabilite la generación de auditorías correctas.
AUTHZ_NO_FAILURE_AUDIT
 Deshabilite la generación de auditorías de errores.
AUTHZ_NO_ALLOC_STRINGS
 Use punteros a las cadenas pasadas en lugar de asignar memoria y copiar las cadenas. La aplicación que realiza la llamada debe asegurarse de que la memoria pasada permanece válida durante las comprobaciones de acceso.

[in] hAuditEventType

Reservado. Este parámetro debe establecerse en NULL.

[in] szOperationType

Cadena que indica la operación que se va a auditar.

[in] szObjectType

Cadena que indica el tipo de objeto al que se accede.

[in] szObjectName

Cadena que indica el nombre del objeto al que se accede.

[in] szAdditionalInfo

Cadena, definida por el Resource Manager, para obtener información de auditoría adicional.

[out] phAuditEvent

Puntero que recibe una estructura de AUTHZ_AUDIT_EVENT_HANDLE .

[in] dwAdditionalParameterCount

Debe establecerse en cero.

...

Parámetros adicionales.

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.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado authz.h
Library Authz.lib
Archivo DLL Authz.dll
Redistribuible Paquete de herramientas de administración de Windows Server 2003 en Windows XP

Consulte también

AuthzAccessCheck

Funciones básicas de Access Control