Función PerfEnumerateCounterSet (perflib.h)

Artículo
03/01/2024

Obtiene los identificadores del conjunto de contadores de los conjuntos de contadores registrados en .

sistema especificado.

Los identificadores del conjunto de contadores son identificadores únicos globales (GUID).

Sintaxis

ULONG PerfEnumerateCounterSet(
  [in, optional]  LPCWSTR szMachine,
  [out, optional] LPGUID  pCounterSetIds,
                  DWORD   cCounterSetIds,
  [out]           LPDWORD pcCounterSetIdsActual
);

Parámetros

[in, optional] szMachine

Nombre de la máquina para la que se van a obtener los identificadores del conjunto de contadores. Si es NULL, la función recupera los identificadores del conjunto de contadores para la máquina local.

[out, optional] pCounterSetIds

Puntero a un búfer que tiene espacio suficiente para recibir el número de GUID que especifica el parámetro cCounterSetIds . Puede ser NULL si

cCounterSetIds es 0.

cCounterSetIds

Tamaño del búfer que especifica el parámetro pCounterSetIds , medido en GUID.

[out] pcCounterSetIdsActual

El tamaño del búfer realmente necesario para obtener los identificadores del conjunto de contadores. El significado depende del valor que la función

Devuelve.

Valor devuelto de la función	Significado de pcCounterSetIdsActual
ERROR_SUCCESS	Número de GUID que la función almacena en el búfer que pCounterSetIds especificó.
ERROR_NOT_ENOUGH_MEMORY	The tamaño (en GUID) del búfer necesario. 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 de la función

Significado de pcCounterSetIdsActual

ERROR_SUCCESS

Número de

GUID que la función almacena en el búfer que pCounterSetIds especificó.

ERROR_NOT_ENOUGH_MEMORY

The

tamaño (en GUID) del búfer necesario. 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 todos los identificadores del conjunto de contenido en el búfer que pCounterSetIds especificó. El valor que pcCounterSetIdsActual apunta a indica el número de identificadores del conjunto de contadores almacenados realmente en el búfer.
ERROR_NOT_ENOUGH_MEMORY	El búfer que pCounterSetIds especificó no era lo suficientemente grande como para almacenar todos los identificadores del conjunto de contadores para los conjuntos de contadores en el sistema especificado. El valor que pcCounterSetIdsActual apunta a indica el tamaño del búfer necesario para almacenar todos los identificadores del conjunto de contadores. Ampliar el búfer al elemento necesario size y vuelva a llamar a la función.

Código devuelto

Descripción

ERROR_SUCCESS

La función almacenó correctamente todos los identificadores del conjunto de contenido en el búfer que pCounterSetIds especificó. El valor que pcCounterSetIdsActual apunta a indica el número de identificadores del conjunto de contadores almacenados realmente en el búfer.

ERROR_NOT_ENOUGH_MEMORY

El búfer que pCounterSetIds especificó no era lo suficientemente grande como para almacenar todos los identificadores del conjunto de contadores para los conjuntos de contadores en el sistema especificado. El valor que pcCounterSetIdsActual apunta a indica el tamaño del búfer necesario para almacenar todos los identificadores del conjunto de contadores. 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.

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

PerfEnumerateCounterSetInstances