Compartilhar via


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

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1607 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho perflib.h
Biblioteca AdvAPI32.lib
DLL AdvAPI32.dll

Confira também

PerfAddCounters

PerfCloseQueryHandle

PerfDeleteCounters

PerfQueryCounterData

PerfQueryCounterInfo