Compartir a través de

Función PerfQueryCounterSetRegistrationInfo (perflib.h)

  • Artículo

Obtiene información sobre un conjunto de contadores en el sistema especificado.

Sintaxis

ULONG PerfQueryCounterSetRegistrationInfo(
  [in, optional]  LPCWSTR         szMachine,
  [in]            LPCGUID         pCounterSetId,
                  PerfRegInfoType requestCode,
                  DWORD           requestLangId,
  [out, optional] LPBYTE          pbRegInfo,
                  DWORD           cbRegInfo,
  [out]           LPDWORD         pcbRegInfoActual
);

Parámetros

[in, optional] szMachine

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

[in] pCounterSetId

Identificador del conjunto de contadores del conjunto de contadores para el que desea obtener información.

requestCode

Tipo de información que desea obtener sobre el conjunto de contadores. Consulte PerfRegInfoType para obtener una lista de los valores posibles.

requestLangId

Identificador de configuración regional preferido para las cadenas que contienen la información solicitada si requestCode es PERF_REG_COUNTERSET_NAME_STRING,

PERF_REG_COUNTERSET_HELP_STRING, PERF_REG_COUNTER_NAME_STRINGS o

PERF_REG_COUNTER_HELP_STRINGS.

Identificador de contador del contador para el que desea datos, si requestCode es PERF_REG_COUNTER_STRUCT.

Establezca en 0 para todos los demás valores de requestCode.

[out, optional] pbRegInfo

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

NULL si cbRegInfo es 0.

cbRegInfo

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

[out] pcbRegInfoActual

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

Devuelve.

Valor devuelto de función Significado de pcbRegInfoActual
ERROR_SUCCESS Número de

bytes de información sobre el conjunto de contadores especificado que la función almacenó en el búfer que pbRegInfo especificó.
ERROR_NOT_ENOUGH_MEMORY The

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

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

Valor devuelto

Código devuelto Descripción
ERROR_SUCCESS
 La función almacenó correctamente toda la información sobre el conjunto de contadores en el búfer que pbRegInfo especificó. El valor que pcbRegInfoActual apunta a indica la cantidad de información almacenada realmente en el búfer, en bytes.
ERROR_NOT_ENOUGH_MEMORY
 El búfer que pbRegInfo especificó no era lo suficientemente grande como para almacenar toda la información sobre el conjunto de contadores. El valor que pcbRegInfoActual apunta a indica el tamaño del búfer necesario para almacenar toda la información. Ampliar el búfer al 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

Consulte PerfRegInfoType para conocer los tipos de datos que puede solicitar y .

los formatos de los datos proporcionados para cada tipo de solicitud.

Requisitos

   
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