Función AuthzInitializeObjectAccessAuditEvent2 (authz.h)

  • Artículo

La función AuthzInitializeObjectAccessAuditEvent2 asigna e inicializa un identificador de AUTHZ_AUDIT_EVENT_HANDLE para su uso con la función AuthzAccessCheck .

Sintaxis

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

Parámetros

[in] Flags

Marcas que modifican el comportamiento de la auditoría. En la siguiente tabla se muestran los valores posibles.

Valor Significado
AUTHZ_NO_ALLOC_STRINGS
 Usa 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.
AUTHZ_NO_FAILURE_AUDIT
 Deshabilita la generación de auditorías de errores.
AUTHZ_NO_SUCCESS_AUDIT
 Deshabilita la generación de auditorías correctas.

[in] hAuditEventType

Reservado. Este parámetro debe establecerse en NULL.

[in] szOperationType

Puntero a una cadena que indica la operación que se va a auditar.

[in] szObjectType

Puntero a una cadena que indica el tipo de objeto al que se tiene acceso.

[in] szObjectName

Puntero a una cadena que indica el nombre del objeto al que se tiene acceso.

[in] szAdditionalInfo

Puntero a una cadena definida por el Resource Manager que contiene información de auditoría adicional.

[in] szAdditionalInfo2

Puntero a una cadena definida por el Resource Manager que contiene información de auditoría adicional.

[out] phAuditEvent

Puntero al identificador de AUTHZ_AUDIT_EVENT_HANDLE devuelto.

[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 No se admite ninguno
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