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

Все вспомогательные функции данных производительности (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 .