Função EventAccessQuery (evntcons.h)

  • Artigo

Recupera as permissões para o controlador ou provedor especificado.

Sintaxe

ULONG EVNTAPI EventAccessQuery(
  [in]      LPGUID               Guid,
  [in, out] PSECURITY_DESCRIPTOR Buffer,
  [in, out] PULONG               BufferSize
);

Parâmetros

[in] Guid

GUID que identifica exclusivamente o provedor ou a sessão.

[in, out] Buffer

Buffer alocado pelo aplicativo que conterá o descritor de segurança do controlador ou provedor.

[in, out] BufferSize

Tamanho do buffer do descritor de segurança, em bytes. Se a função for bem-sucedida, esse parâmetro receberá o tamanho do buffer usado. Se o buffer for muito pequeno, a função retornará ERROR_MORE_DATA e esse parâmetro receberá o tamanho do buffer necessário. Se o tamanho do buffer for zero na entrada, nenhum dado será retornado no buffer e esse parâmetro receberá o tamanho do buffer necessário.

Retornar valor

Retorna ERROR_SUCCESS se tiver êxito.

A função retornará o seguinte código de retorno se ocorrer um erro:

Código de retorno Descrição
ERROR_MORE_DATA
 O buffer é muito pequeno para receber o descritor de segurança. Realocar o buffer usando o tamanho retornado em BufferSize.

Comentários

Se o GUID não existir no registro, o ETW retornará as permissões padrão para um provedor ou controlador. Para obter detalhes sobre como especificar o GUID no registro, consulte EventAccessControl.

Para obter informações sobre como acessar os componentes do descritor de segurança, consulte Obtendo informações de uma ACL, as funções GetSecurityDescriptorDacl, GetSecurityDescriptorSacl e GetAce e a estrutura ACE .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho evntcons.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

EventAccessControl

EventAccessRemove