Função AuthzInitializeObjectAccessAuditEvent (authz.h)

  • Artigo

A função AuthzInitializeObjectAccessAuditEvent inicializa a auditoria de um objeto .

Sintaxe

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 a auditoria. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
AUTHZ_NO_SUCCESS_AUDIT
 Desabilitar a geração de auditorias de êxito.
AUTHZ_NO_FAILURE_AUDIT
 Desabilite a geração de auditorias de falha.
AUTHZ_NO_ALLOC_STRINGS
 Use ponteiros para as cadeias de caracteres passadas em vez de alocar memória e copiar as cadeias de caracteres. O aplicativo de chamada deve garantir que a memória passada permaneça válida durante as verificações de acesso.

[in] hAuditEventType

Reservado. Esse parâmetro deve ser definido como NULL.

[in] szOperationType

Cadeia de caracteres que indica a operação que deve ser auditada.

[in] szObjectType

Cadeia de caracteres que indica o tipo de objeto que está sendo acessado.

[in] szObjectName

Cadeia de caracteres indica o nome do objeto que está sendo acessado.

[in] szAdditionalInfo

Cadeia de caracteres, definida pelo Resource Manager, para obter informações adicionais de auditoria.

[out] phAuditEvent

Ponteiro que recebe uma estrutura AUTHZ_AUDIT_EVENT_HANDLE .

[in] dwAdditionalParameterCount

Deve ser definido como zero.

...

Parâmetros adicionais.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

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]
Plataforma de Destino Windows
Cabeçalho authz.h
Biblioteca Authz.lib
DLL Authz.dll
Redistribuível Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP

Confira também

AuthzAccessCheck

Funções de Controle de Acesso básicas