Função AuthzInitializeObjectAccessAuditEvent (authz.h)

Artigo
02/23/2024

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

Compartilhar via