Compartilhar via


Função PdhVbOpenQuery

A função PdhVbOpenQuery cria e inicializa uma estrutura de consulta exclusiva que é usada para gerenciar a coleta de dados de desempenho.

Importante

A função que este tópico descreve pode estar alterada ou indisponível no futuro. Em vez disso, a Microsoft recomenda que você use as funções descritas em Funções de Contadores de Desempenho.

Function PdhVbOpenQuery( _ ByVal QueryHandle As Long _ ) As Long

Parâmetros

QueryHandle

Variável que é limpa (é igual a 0) antes que a função seja chamada e, se a função for bem-sucedida, contém a ID exclusiva da consulta que é criada e aberta. Esse identificador é usado nas chamadas subsequentes para outras funções PDH para identificar a consulta.

Valor retornado

Se a função for bem-sucedida, ela retornará um inteiro Long igual a ERROR_SUCCESS e um novo identificador na variável QueryHandle .

Se a função falhar, o valor retornado será um código de erro do sistema ou um código de erro PDH. Veja a seguir os valores possíveis.

Código de retorno Descrição
PDH_INVALID_ARGUMENT
O argumento é inválido ou incorreto.
PDH_MEMORY_ALLOCATION_FAILURE
Não foi possível alocar um buffer de memória temporário.

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]
Biblioteca
Pdh.lib
DLL
Pdh.dll

Confira também

PdhCloseQuery