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

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

  • Статья

Извлекает указатель на указанный экземпляр набора счетчиков. Поставщики используют эту функцию.

Синтаксис

PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
  [in] HANDLE  ProviderHandle,
  [in] LPCGUID CounterSetGuid,
  [in] PCWSTR  Name,
  [in] ULONG   Id
);

Параметры

[in] ProviderHandle

Дескриптор поставщика. Используйте переменную дескриптора, созданную инструментом CTRPP . Имя переменной см. в атрибуте символа элемента provider .

Windows Vista: Функция PerfStartProvider возвращает дескриптор.

[in] CounterSetGuid

GUID, который однозначно идентифицирует набор счетчиков, к которому требуется выполнить запрос. Это тот же ИДЕНТИФИКАТОР GUID, который указан в атрибуте GUID элемента counterSet . Используйте переменную GUID, созданную средством CTRPP . Имя переменной см. в атрибуте символа элемента counterSet .

Windows Vista: Переменная GUID недоступна.

[in] Name

Строка Юникода, завершающаяся null, которая содержит имя экземпляра набора счетчиков, который требуется извлечь.

[in] Id

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

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

Структура PERF_COUNTERSET_INSTANCE , содержащая экземпляр набора счетчиков или значение NULL , если экземпляр не существует.

Эта функция возвращает значение NULL , если произошла ошибка. Чтобы определить возникную ошибку, вызовите Метод GetLastError.

Комментарии

Используйте те же имя и идентификатор экземпляра, которые использовались при вызове PerfCreateInstance , чтобы получить определенный экземпляр набора счетчиков.

Поставщики должны кэшировать указатель на экземпляр при создании экземпляра, а не вызывать эту функцию для получения указателя.

Требования

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

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

PerfCreateInstance