Compartir a través de

Función PerfEnumerateCounterSetInstances (perflib.h)

  • Artículo

Obtiene los nombres e identificadores de las instancias activas de un contador establecido en .

sistema especificado.

Sintaxis

ULONG PerfEnumerateCounterSetInstances(
  [in, optional]  LPCWSTR               szMachine,
  [in]            LPCGUID               pCounterSetId,
  [out, optional] PPERF_INSTANCE_HEADER pInstances,
                  DWORD                 cbInstances,
  [out]           LPDWORD               pcbInstancesActual
);

Parámetros

[in, optional] szMachine

Nombre de la máquina para la que se obtiene la información sobre las instancias activas del conjunto de contadores que especifica el parámetro pCounterSet . Si es NULL, la función recupera información sobre las instancias activas del conjunto de contadores especificado para el equipo local.

[in] pCounterSetId

Identificador del conjunto de contadores del conjunto de contadores para el que desea obtener la información sobre las instancias activas.

[out, optional] pInstances

Puntero a un búfer lo suficientemente grande como para recibir la cantidad de datos que especifica el parámetro cbInstances . Quizás

NULL si cbInstances es 0.

cbInstances

Tamaño del búfer que especifica el parámetro pInstances , en bytes.

[out] pcbInstancesActual

El tamaño del búfer realmente necesario para obtener la información sobre las instancias activas. El significado depende del valor que la función

Devuelve.

Valor devuelto de la función Significado de pcbInstancesActual
ERROR_SUCCESS Número de

bytes de información sobre las instancias activas del conjunto de contadores especificado que la función almacenada en el búfer que pInstances especificó.
ERROR_NOT_ENOUGH_MEMORY The

tamaño del búfer necesario para almacenar la información sobre las instancias activas del contador establecido en el equipo especificado, en bytes. Ampliar el búfer al elemento necesario

size y vuelva a llamar a la función.
Otros El valor no está definido y no debe usarse.

Valor devuelto

Código devuelto Descripción
ERROR_SUCCESS
 La función almacenó correctamente toda la información sobre las instancias activas del contador establecido en el búfer especificado por pInstances . El valor que pcbInstancesActual apunta a indica la cantidad de información almacenada realmente en el búfer, en bytes.
ERROR_NOT_ENOUGH_MEMORY
 El búfer especificado por pInstances no era lo suficientemente grande como para almacenar toda la información sobre las instancias activas del conjunto de contadores. El valor que pcbInstancesActual apunta a indica el tamaño del búfer necesario para almacenar toda la información. Ampliar el búfer al elemento necesario

size y vuelva a llamar a la función.
 

Para otros tipos de errores, el valor devuelto es un código de error del sistema.

Comentarios

La información sobre las instancias activas del conjunto de contadores especificado se escribe en el búfer que pInstances especifica como una secuencia de bloques de PERF_INSTANCE_HEADER . Tamaño en bytes de

la secuencia de bloques se escribe en pcbInstancesActual. Cada bloque de PERF_INSTANCE_HEADER consta

de una estructura de PERF_INSTANCE_HEADER , seguida inmediatamente de una UTF-16LE terminada en null

nombre de instancia, seguido de relleno para que el tamaño del

PERF_INSTANCE_HEADER bloque es un múltiplo de 8 bytes.

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

Consulte también

PERF_INSTANCE_HEADER

PerfEnumerateCounterSet