Функция PerfOpenQueryHandle (perflib.h)
Создает дескриптор, который ссылается на запрос в указанной системе. Запрос — это список спецификаций счетчиков.
Синтаксис
ULONG PerfOpenQueryHandle(
[in, optional] LPCWSTR szMachine,
[out] HANDLE *phQuery
);
Параметры
[in, optional] szMachine
Имя компьютера, для которого требуется получить дескриптор запроса.
[out] phQuery
Дескриптор запроса. Вызовите PerfCloseQueryHandle , чтобы закрыть дескриптор, когда он вам больше не нужен.
Возвращаемое значение
Если функция завершается успешно, она возвращает ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки.
Комментарии
Используйте PerfAddCounters и PerfDeleteCounters для добавления или удаления спецификаций счетчиков в список. Используйте PerfQueryCounterInfo , чтобы получить спецификации счетчиков, которые в настоящее время находятся в списке, и определить индексы, по которым данные для каждого счетчика будут возвращены PerfQueryCounterData. Используйте PerfQueryCounterData для получения значений счетчиков, соответствующих спецификациям счетчиков.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 версии 1607 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2016 [только классические приложения] |
| Целевая платформа | Windows |
| Header | perflib.h |
| Библиотека | AdvAPI32.lib |
| DLL | AdvAPI32.dll |