Функция 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 |