Função EventAccessQuery (evntcons.h)
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 |
|---|---|
|
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 |