Функция PerfQueryCounterSetRegistrationInfo (perflib.h)

  • Статья

Возвращает сведения о наборе счетчиков в указанной системе.

Синтаксис

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

Параметры

[in, optional] szMachine

Имя компьютера, для которого необходимо получить сведения о наборе счетчиков, заданные параметром pCounterSet . Если значение РАВНО NULL, функция получает сведения об указанном наборе счетчиков для локального компьютера.

[in] pCounterSetId

Идентификатор набора счетчиков, для которого требуется получить сведения.

requestCode

Тип сведений, которые требуется получить о наборе счетчиков. Список возможных значений см. в разделе PerfRegInfoType .

requestLangId

Предпочтительный идентификатор языкового стандарта для строк, содержащих запрошенные сведения, если аргумент requestCode имеет значение PERF_REG_COUNTERSET_NAME_STRING.

PERF_REG_COUNTERSET_HELP_STRING, PERF_REG_COUNTER_NAME_STRINGS или

PERF_REG_COUNTER_HELP_STRINGS.

Идентификатор счетчика, для которого нужны данные, если аргумент requestCodePERF_REG_COUNTER_STRUCT.

Задайте значение 0 для всех остальных значений requestCode.

[out, optional] pbRegInfo

Указатель на буфер, который достаточно велик для получения объема данных, указанного параметром cbRegInfo , в байтах. Может быть

Значение NULL, если cbRegInfo имеет значение 0.

cbRegInfo

Размер буфера, указанного параметром pbRegInfo , в байтах.

[out] pcbRegInfoActual

Размер буфера, фактически необходимый для получения сведений о наборе счетчиков. Значение зависит от значения функции.

Возвращает.

Возвращаемое значение функции Значение pcbRegInfoActual
ERROR_SUCCESS Число

байты сведений об указанном наборе счетчиков, которые функция хранит в буфере, указанном pbRegInfo .
ERROR_NOT_ENOUGH_MEMORY The

размер буфера, необходимого для хранения сведений о счетчике, заданном на указанном компьютере, в байтах. Увеличение буфера до требуемого

size и снова вызовите функцию.
Другое Значение не определено и не должно использоваться.

Возвращаемое значение

Код возврата Описание
ERROR_SUCCESS
 Функция успешно сохранила все сведения о наборе счетчиков в буфере, указанном pbRegInfo . Значение, на которое указывает pcbRegInfoActual , указывает объем информации, фактически хранящейся в буфере, в байтах.
ERROR_NOT_ENOUGH_MEMORY
 Буфер, указанный pbRegInfo , не был достаточно велик для хранения всех сведений о наборе счетчиков. Значение, на которое указывает pcbRegInfoActual , указывает размер буфера, необходимого для хранения всей информации. Увеличение буфера до требуемого

size и снова вызовите функцию.
 

Для других типов сбоев возвращаемым значением является системный код ошибки.

Комментарии

Типы данных, которые можно запрашивать, см. в разделе PerfRegInfoType .

форматы данных, предоставляемые для каждого типа запроса.

Требования

   
Минимальная версия клиента Windows 10 версии 1607 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header perflib.h
Библиотека AdvAPI32.lib
DLL AdvAPI32.dll