Función PerfOpenQueryHandle (perflib.h)

Artículo
03/08/2023

Crea un identificador que hace referencia a una consulta en el sistema especificado. Una consulta es una lista de especificaciones de contador.

Sintaxis

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

Parámetros

[in, optional] szMachine

Nombre del equipo para el que desea obtener el identificador de consulta.

[out] phQuery

Identificador de la consulta. Llame a PerfCloseQueryHandle para cerrar el identificador cuando ya no lo necesite.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema.

Comentarios

Use PerfAddCounters y PerfDeleteCounters para agregar o quitar especificaciones de contador a la lista. Use PerfQueryCounterInfo para obtener las especificaciones del contador actualmente en la lista y para determinar los índices en los que perfQueryCounterData devolverá los datos de cada contador. Use PerfQueryCounterData para recuperar los valores de los contadores que coinciden con las especificaciones del contador.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1607 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	perflib.h
Library	AdvAPI32.lib
Archivo DLL	AdvAPI32.dll