Função PerfOpenQueryHandle (perflib.h)

Cria um identificador que faz referência a uma consulta no sistema especificado. Uma consulta é uma lista de especificações de contador.

Sintaxe

ULONG PerfOpenQueryHandle(
  [in, optional] LPCWSTR szMachine,
  [out]          HANDLE  *phQuery
);

Parâmetros

[in, optional] szMachine

O nome do computador para o qual você deseja obter o identificador de consulta.

[out] phQuery

O identificador para a consulta. Chame PerfCloseQueryHandle para fechar o identificador quando você não precisar mais dele.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema.

Comentários

Use PerfAddCounters e PerfDeleteCounters para adicionar ou remover especificações de contador à lista. Use PerfQueryCounterInfo para obter as especificações do contador atualmente na lista e para determinar os índices nos quais os dados de cada contador serão retornados por PerfQueryCounterData. Use PerfQueryCounterData para recuperar os valores dos contadores que correspondem às especificações do contador.

Requisitos

Confira também

PerfAddCounters

PerfCloseQueryHandle

PerfDeleteCounters

PerfQueryCounterData

PerfQueryCounterInfo