Compartir a través de

Función PerfEnumerateCounterSet (perflib.h)

  • Artículo

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

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