Compartilhar via


Função PdhCloseQuery (pdh.h)

Fecha todos os contadores contidos na consulta especificada, fecha todos os identificadores relacionados à consulta e libera toda a memória associada à consulta.

Sintaxe

PDH_FUNCTION PdhCloseQuery(
  [in] PDH_HQUERY hQuery
);

Parâmetros

[in] hQuery

Manipule para a consulta a ser fechada. Esse identificador é retornado pela função PdhOpenQuery .

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS. Caso contrário, a função retornará um código de erro do sistema ou um código de erro PDH.

Veja a seguir um valor possível.

Código de retorno Descrição
PDH_INVALID_HANDLE
O identificador de consulta não é válido.

Comentários

Não use os identificadores de contador associados a essa consulta depois de chamar essa função.

A seguir, mostra a sintaxe ao chamar essa função do Visual Basic.

PdhCloseQuery(
  ByVal QueryHandle as Long  
)
as Long

Exemplos

Para obter um exemplo, consulte Navegando contadores de desempenho ou lendo dados de desempenho de um arquivo de log.

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

Confira também

PdhOpenQuery