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

Статья
03/01/2024

Возвращает идентификаторы наборов счетчиков, зарегистрированных в

указанная система.

Идентификаторы набора счетчиков — это глобальные уникальные идентификаторы (GUID).

Синтаксис

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

Параметры

[in, optional] szMachine

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

[out, optional] pCounterSetIds

Указатель на буфер, в котором достаточно места для получения количества идентификаторов GUID, указанного параметром cCounterSetIds . Может иметь значение NULL, если

cCounterSetIds равно 0.

cCounterSetIds

Размер буфера, заданного параметром pCounterSetIds , измеряется в идентификаторах GUID.

[out] pcCounterSetIdsActual

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

Возвращает.

Возвращаемое значение функции	Значение pcCounterSetIdsActual
ERROR_SUCCESS	Число Идентификаторы GUID, хранимые функцией в буфере, указанном pCounterSetIds .
ERROR_NOT_ENOUGH_MEMORY	The размер (в идентификаторах GUID) требуемого буфера. Увеличение буфера до требуемого size и снова вызовите функцию .
Другое	Значение не определено и не должно использоваться.

Возвращаемое значение функции

Значение pcCounterSetIdsActual

ERROR_SUCCESS

Число

Идентификаторы GUID, хранимые функцией в буфере, указанном pCounterSetIds .

ERROR_NOT_ENOUGH_MEMORY

The

размер (в идентификаторах GUID) требуемого буфера. Увеличение буфера до требуемого

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

Другое

Значение не определено и не должно использоваться.

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

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

Код возврата

Описание

ERROR_SUCCESS

Функция успешно сохранила все идентификаторы набора содержимого в буфере, указанном pCounterSetIds . Значение, указываемое pcCounterSetIdsActual , указывает количество идентификаторов наборов счетчиков, фактически хранящихся в буфере.

ERROR_NOT_ENOUGH_MEMORY

Буфер, указанный pCounterSetIds , не был достаточно велик для хранения всех идентификаторов набора счетчиков для наборов счетчиков в указанной системе. Значение, указываемое pcCounterSetIdsActual , указывает размер буфера, необходимый для хранения всех идентификаторов набора счетчиков. Увеличение буфера до требуемого

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

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

Требования

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

См. также раздел

PerfEnumerateCounterSetInstances

Поделиться через