Códigos de erro de auxiliar de dados de desempenho

Todas as funções PDH (Auxiliar de Dados de Desempenho) retornam um valor do tipo PDH_STATUS. Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS. Caso contrário, a função retornará um código de erro do sistema ou um código de erro PDH. Para recuperar o texto de descrição do erro em seu aplicativo, use a função FormatMessage , conforme mostrado no exemplo a seguir.

#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);
}

Para funções de coleta e formatação de dados, é importante lembrar que o valor retornado da função indica o êxito ou o erro da chamada de função e não necessariamente o dos dados do contador. Sempre marcar o membro CStatus do valor do contador retornado para garantir que os dados retornados sejam válidos antes de usá-los. Se o valor do membro CStatus não indicar êxito, não use os dados.

A tabela a seguir fornece uma lista de códigos de erro específicos do PDH. Esses valores são definidos no arquivo de pdhmsg.h cabeçalho.