Função AuthzInitializeObjectAccessAuditEvent2 (authz.h)

Artigo
02/23/2024

A função AuthzInitializeObjectAccessAuditEvent2 aloca e inicializa um identificador de AUTHZ_AUDIT_EVENT_HANDLE para uso com a função AuthzAccessCheck .

Sintaxe

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

Sinalizadores que modificam o comportamento da auditoria. A tabela a seguir mostra os valores possíveis.

Valor	Significado
AUTHZ_NO_ALLOC_STRINGS	Usa 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.
AUTHZ_NO_FAILURE_AUDIT	Desabilita a geração de auditorias de falha.
AUTHZ_NO_SUCCESS_AUDIT	Desabilita a geração de auditorias de êxito.

[in] hAuditEventType

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

[in] szOperationType

Um ponteiro para uma cadeia de caracteres que indica a operação que deve ser auditada.

[in] szObjectType

Um ponteiro para uma cadeia de caracteres que indica o tipo de objeto acessado.

[in] szObjectName

Um ponteiro para uma cadeia de caracteres que indica o nome do objeto acessado.

[in] szAdditionalInfo

Ponteiro para uma cadeia de caracteres definida pelo Resource Manager que contém informações adicionais de auditoria.

[in] szAdditionalInfo2

Ponteiro para uma cadeia de caracteres definida pelo Resource Manager que contém informações adicionais de auditoria.

[out] phAuditEvent

Um ponteiro para o identificador de AUTHZ_AUDIT_EVENT_HANDLE retornado.

[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	Nenhum compatível
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 básicas de Controle de Acesso