Función PerfQueryInstance (perflib.h)

  • Artículo

Recupera un puntero a la instancia del conjunto de contadores especificado. Los proveedores usan esta función.

Sintaxis

PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
  [in] HANDLE  ProviderHandle,
  [in] LPCGUID CounterSetGuid,
  [in] PCWSTR  Name,
  [in] ULONG   Id
);

Parámetros

[in] ProviderHandle

Identificador del proveedor. Use la variable handle que generó la herramienta CTRPP automáticamente. Para obtener el nombre de la variable, vea el atributo symbol del elemento provider .

Windows Vista: La función PerfStartProvider devuelve el identificador.

[in] CounterSetGuid

GUID que identifica de forma única el conjunto de contadores que desea consultar. Se trata del mismo GUID especificado en el atributo guid del elemento counterSet . Use la variable GUID que la herramienta CTRPP generó automáticamente. Para obtener el nombre de la variable, vea el atributo symbol del elemento counterSet .

Windows Vista: La variable GUID no está disponible.

[in] Name

Cadena Unicode terminada en NULL que contiene el nombre de la instancia del conjunto de contadores que desea recuperar.

[in] Id

Identificador único de la instancia del conjunto de contadores que desea recuperar.

Valor devuelto

Estructura PERF_COUNTERSET_INSTANCE que contiene la instancia del conjunto de contadores o NULL si la instancia no existe.

Esta función devuelve NULL si se produjo un error. Para determinar el error que se produjo, llame a GetLastError.

Comentarios

Use el mismo nombre y identificador de instancia que usó al llamar a PerfCreateInstance para recuperar una instancia específica del conjunto de contadores.

Los proveedores deben almacenar en caché el puntero a la instancia cuando creen la instancia en lugar de llamar a esta función para recuperar el puntero.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado perflib.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

PerfCreateInstance