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

Коды ошибок вспомогательного приложения для получения данных о производительности

  • Статья

Все вспомогательные функции данных производительности (PDH) возвращают значение типа PDH_STATUS. Если функция выполнена успешно, возвращается ERROR_SUCCESSзначение. В противном случае функция возвращает системный код ошибки или код ошибки PDH. Чтобы получить текст описания ошибки в приложении, используйте функцию FormatMessage , как показано в следующем примере.

#include <windows.h>
#include <stdio.h>
#include <pdhmsg.h>

void main(void)
{
    HANDLE hPdhLibrary = NULL;
    LPWSTR pMessage = NULL;
    DWORD dwErrorCode = PDH_PLA_ERROR_ALREADY_EXISTS;

    hPdhLibrary = LoadLibrary(L"pdh.dll");
    if (NULL == hPdhLibrary)
    {
        wprintf(L"LoadLibrary failed with %lu\n", GetLastError());
        return;
    }

    if (!FormatMessage(FORMAT_MESSAGE_FROM_HMODULE |
                       FORMAT_MESSAGE_ALLOCATE_BUFFER |
                       FORMAT_MESSAGE_IGNORE_INSERTS,
                       hPdhLibrary,
                       dwErrorCode,
                       0,
                       (LPWSTR)&pMessage,
                       0,
                       NULL))
    {
        wprintf(L"Format message failed with 0x%x\n", GetLastError());
        return;
    }

    wprintf(L"Formatted message: %ls\n", pMessage);
    LocalFree(pMessage);
}

Для функций сбора и форматирования данных важно помнить, что возвращаемое значение функции указывает на успешность или ошибку вызова функции, а не обязательно для данных счетчика. Всегда проверка член CStatus возвращаемого значения счетчика, чтобы убедиться, что возвращенные данные допустимы перед использованием. Если значение элемента CStatus не указывает на успех, не используйте данные.

В следующей таблице приведен список кодов ошибок, относящихся к PDH. Эти значения определены в файле заголовка pdhmsg.h .

Код ошибки Description
0x00000000 (PDH_CSTATUS_VALID_DATA) Возвращаемые данные допустимы.
0x00000001 (PDH_CSTATUS_NEW_DATA) Возвращаемое значение данных является допустимым и отличается от последнего примера.
0x800007D0 (PDH_CSTATUS_NO_MACHINE) Не удается подключиться к указанному компьютеру или компьютер находится в автономном режиме.
0x800007D1 (PDH_CSTATUS_NO_INSTANCE) Указанный экземпляр отсутствует.
0x800007D2 (PDH_MORE_DATA) Существует больше данных для возврата, чем в предоставленном буфере. Выделите больший буфер и снова вызовите функцию.
0x800007D3 (PDH_CSTATUS_ITEM_NOT_VALIDATED) Элемент данных добавлен в запрос, но не был проверен и недоступен. Другие сведения о состоянии этого элемента данных недоступны.
0x800007D4 (PDH_RETRY) Выбранная операция должна быть извлечена.
0x800007D5 (PDH_NO_DATA) Нет возвращаемых данных.
0x800007D6 (PDH_CALC_NEGATIVE_DENOMINATOR) Обнаружен счетчик с отрицательным значением знаменателя.
0x800007D7 (PDH_CALC_NEGATIVE_TIMEBASE) Обнаружен счетчик с отрицательным базовым значением времени.
0x800007D8 (PDH_CALC_NEGATIVE_VALUE) Обнаружен счетчик с отрицательным значением.
0x800007D9 (PDH_DIALOG_CANCELLED) Пользователь отменил диалоговое окно.
0x800007DA (PDH_END_OF_LOG_FILE) Был достигнут конец файла журнала.
0x800007DB (PDH_ASYNC_QUERY_TIMEOUT) Время ожидания завершения потока асинхронной коллекции счетчиков произошло.
0x800007DC (PDH_CANNOT_SET_DEFAULT_REALTIME_DATASOURCE) Не удается изменить источник данных по умолчанию в режиме реального времени. Существуют сеансы запросов в режиме реального времени, собирающие данные счетчика.
0xC0000BB8 (PDH_CSTATUS_NO_OBJECT) Указанный объект не найден в системе.
0xC0000BB9 (PDH_CSTATUS_NO_COUNTER) Не удалось найти указанный счетчик.
0xC0000BBA (PDH_CSTATUS_INVALID_DATA) Возвращаемые данные недопустимы.
0xC0000BBB (PDH_MEMORY_ALLOCATION_FAILURE) Функция PDH не могла выделить достаточно временной памяти для завершения операции. Закройте некоторые приложения или расширьте файл страницы и повторите функцию.
0xC0000BBC (PDH_INVALID_HANDLE) Дескриптор не является допустимым объектом PDH.
0xC0000BBD (PDH_INVALID_ARGUMENT) Обязательный аргумент отсутствует или неверный.
0xC0000BBE (PDH_FUNCTION_NOT_FOUND) Не удалось найти указанную функцию.
0xC0000BBF (PDH_CSTATUS_NO_COUNTERNAME) Счетчик не указан.
0xC0000BC0 (PDH_CSTATUS_BAD_COUNTERNAME) Не удается проанализировать путь счетчика. Проверьте формат и синтаксис указанного пути.
0xC0000BC1 (PDH_INVALID_BUFFER) Буфер, переданный вызывающим объектом, недопустим.
0xC0000BC2 (PDH_INSUFFICIENT_BUFFER) Запрошенные данные больше, чем предоставленный буфер. Не удалось вернуть запрошенные данные.
0xC0000BC3 (PDH_CANNOT_CONNECT_MACHINE) Не удается подключиться к запрошенной компьютеру.
0xC0000BC4 (PDH_INVALID_PATH) Не удалось интерпретировать указанный путь счетчика.
0xC0000BC5 (PDH_INVALID_INSTANCE) Не удалось прочитать имя экземпляра из указанного пути счетчика.
0xC0000BC6 (PDH_INVALID_DATA) Недопустимые данные.
0xC0000BC7 (PDH_NO_DIALOG_DATA) Блок данных диалогового окна отсутствует или недопустим.
0xC0000BC8 (PDH_CANNOT_READ_NAME_STRINGS) Не удается прочитать счетчик и /или текст справки с указанного компьютера.
0xC0000BC9 (PDH_LOG_FILE_CREATE_ERROR) Не удалось создать указанный файл журнала.
0xC0000BCA (PDH_LOG_FILE_OPEN_ERROR) Не удается открыть указанный файл журнала.
0xC0000BCB (PDH_LOG_TYPE_NOT_FOUND) Указанный тип файла журнала не установлен в этой системе.
0xC0000BCC (PDH_NO_MORE_DATA) Больше нет доступных данных.
0xC0000BCD (PDH_ENTRY_NOT_IN_LOG_FILE) Указанная запись не найдена в файле журнала.
0xC0000BCE (PDH_DATA_SOURCE_IS_LOG_FILE) Указанный источник данных — это файл журнала.
0xC0000BCF (PDH_DATA_SOURCE_IS_REAL_TIME) Указанный источник данных — текущее действие.
0xC0000BD0 (PDH_UNABLE_READ_LOG_HEADER) Не удалось прочитать заголовок файла журнала.
0xC0000BD1 (PDH_FILE_NOT_FOUND) Не удалось найти указанный файл.
0xC0000BD2 (PDH_FILE_ALREADY_EXISTS) Файл уже имеет указанное имя файла.
0xC0000BD3 (PDH_NOT_IMPLEMENTED) Ссылка на функцию не реализована.
0xC0000BD4 (PDH_STRING_NOT_FOUND) Не удалось найти указанную строку в списке имени производительности и помочь текстовым строкам.
0x80000BD5 (PDH_UNABLE_MAP_NAME_FILES) Не удалось сопоставить файлы данных счетчика производительности. Данные будут считываться из реестра и храниться локально.
0xC0000BD6 (PDH_UNKNOWN_LOG_FORMAT) Формат указанного файла журнала не распознается библиотекой DLL PDH.
0xC0000BD7 (PDH_UNKNOWN_LOGSVC_COMMAND) Указанное значение команды службы журналов не распознается.
0xC0000BD8 (PDH_LOGSVC_QUERY_NOT_FOUND) Указанный запрос из службы журналов не удалось найти или не удалось открыть.
0xC0000BD9 (PDH_LOGSVC_NOT_OPENED) Не удалось открыть ключ службы журнала данных производительности. Это может быть связано с недостаточной привилегией или из-за того, что служба не установлена.
0xC0000BDA (PDH_WBEM_ERROR) Произошла ошибка при доступе к хранилищу данных WBEM.
0xC0000BDB (PDH_ACCESS_DENIED) Не удается получить доступ к требуемому компьютеру или службе. Проверьте разрешения и проверку подлинности службы журналов или интерактивного сеанса пользователя для отслеживаемых пользователей на компьютере или службе.
0xC0000BDC (PDH_LOG_FILE_TOO_SMALL) Максимальный размер файла журнала слишком мал, чтобы регистрировать выбранные счетчики. В этом файле журнала данные не записываются. Укажите меньший набор счетчиков для журнала или большего размера файла и повторите этот вызов.
0xC0000BDD (PDH_INVALID_DATASOURCE) Не удается подключиться к имени источника данных ODBC.
0xC0000BDE (PDH_INVALID_SQLDB) База данных SQL не содержит допустимый набор таблиц для Perfmon.
0xC0000BDF (PDH_NO_COUNTERS) Для этого набора журналов PERfmon SQL не найдены счетчики.
0xC0000BE0 (PDH_SQL_ALLOC_FAILED) Сбой вызова SQLAllocStmt с %1.
0xC0000BE1 (PDH_SQL_ALLOCCON_FAILED) Вызов SQLAlloc Подключение произошел с ошибкой %1.
0xC0000BE2 (PDH_SQL_EXEC_DIRECT_FAILED) Сбой вызова SQLExecDirect с %1.
0xC0000BE3 (PDH_SQL_FETCH_FAILED) Сбой вызова SQLFetch с %1.
0xC0000BE4 (PDH_SQL_ROWCOUNT_FAILED) Сбой вызова SQLRowCount с %1.
0xC0000BE5 (PDH_SQL_MORE_RESULTS_FAILED) Сбой вызова SQLMoreResults с %1.
0xC0000BE6 (PDH_SQL_CONNECT_FAILED) Вызов SQL Подключение произошел сбоем с %1.
0xC0000BE7 (PDH_SQL_BIND_FAILED) Сбой вызова SQLBindCol с %1.
0xC0000BE8 (PDH_CANNOT_CONNECT_WMI_SERVER) Не удается подключиться к серверу WMI на запрошенном компьютере.
0xC0000BE9 (PDH_PLA_COLLECTION_ALREADY_RUNNING) Коллекция "%1!s!" уже запущена.
0xC0000BEA (PDH_PLA_ERROR_SCHEDULE_OVERLAP) Указанное время начала после окончания.
0xC0000BEB (PDH_PLA_COLLECTION_NOT_FOUND) Коллекция "%1!s!" не существует.
0xC0000BEC (PDH_PLA_ERROR_SCHEDULE_ELAPSED) Указанное время окончания уже истекло.
0xC0000BED (PDH_PLA_ERROR_NOSTART) Коллекция "%1!s!" не начиналась; проверка журнал событий приложения для любых ошибок.
0xC0000BEE (PDH_PLA_ERROR_ALREADY_EXISTS) Коллекция "%1!s!" уже существует.
0xC0000BEF (PDH_PLA_ERROR_TYPE_MISMATCH) В типе параметров имеется несоответствие.
0xC0000BF0 (PDH_PLA_ERROR_FILEPATH) Указанные сведения не разрешаются в допустимое имя пути.
0xC0000BF1 (PDH_PLA_SERVICE_ERROR) Служба "Журналы производительности и оповещения" не ответила.
0xC0000BF2 (PDH_PLA_VALIDATION_ERROR) Передаваемая информация недопустима.
0x80000BF3 (PDH_PLA_VALIDATION_WARNING) Передаваемая информация недопустима.
0xC0000BF4 (PDH_PLA_ERROR_NAME_TOO_LONG) Указанное имя слишком длинное.
0xC0000BF5 (PDH_INVALID_SQL_LOG_FORMAT) Неправильный формат журнала SQL. Правильный формат.SQL:<DSN-name>!<LogSet-Name>
0xC0000BF6 (PDH_COUNTER_ALREADY_IN_QUERY) Счетчик производительности в вызове PdhAddCounter уже добавлен в запрос производительности. Этот счетчик игнорируется.
0xC0000BF7 (PDH_BINARY_LOG_CORRUPT) Не удается считывать данные счетчика и данные из входных двоичных файлов журнала.
0xC0000BF8 (PDH_LOG_SAMPLE_TOO_SMALL) По крайней мере один из входных двоичных файлов журнала содержит менее двух примеров данных.
0xC0000BF9 (PDH_OS_LATER_VERSION) Версия операционной системы на компьютере с именем %1 позже, чем на локальном компьютере. Эта операция недоступна на локальном компьютере.
0xC0000BFA (PDH_OS_EARLIER_VERSION) %1 поддерживает %2 или более поздней версии. Проверьте версию операционной системы на компьютере с именем %3.
0xC0000BFB (PDH_INCORRECT_APPEND_TIME) Выходной файл должен содержать более ранние данные, чем добавляемый файл.
0xC0000BFC (PDH_UNMATCHED_APPEND_COUNTER) Оба файла должны иметь одинаковые счетчики для добавления.
0xC0000BFD (PDH_SQL_ALTER_DETAIL_FAILED) Невозможно изменить макет таблицы CounterDetail в базе данных SQL.
0xC0000BFE (PDH_QUERY_PERF_DATA_TIMEOUT) Система занята. Время ожидания произошло при сборе данных счетчика. Повторите попытку позже или увеличьте значение реестра CollectTime .