Helper-foutcodes voor prestatiegegevens

Alle PDH-functies (Performance Data Helper) retourneren een waarde van het type PDH_STATUS. Als de functie slaagt, wordt de retourwaarde ERROR_SUCCESS. Anders retourneert de functie een systeemfoutcode of een PDH-foutcode. Als u de beschrijvingstekst voor de fout in uw toepassing wilt ophalen, gebruikt u de functie FormatMessage, zoals wordt weergegeven in het volgende voorbeeld.

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

Voor functies voor het verzamelen en opmaken van gegevens is het belangrijk om te onthouden dat de retourwaarde van de functie het succes of de fout van de functie-aanroep aangeeft en niet noodzakelijkerwijs die van de tellergegevens. Controleer altijd het CStatus- lid van de tellerwaarde die wordt geretourneerd om ervoor te zorgen dat de geretourneerde gegevens geldig zijn voordat u deze gebruikt. Als de waarde van het CStatus lid geen succes aangeeft, gebruik de gegevens niet.

De volgende tabel bevat een lijst met foutcodes die specifiek zijn voor PDH. Deze waarden worden gedefinieerd in het pdhmsg.h headerbestand.