Felkoder för prestandadatahjälp

Alla PDH-funktioner (Performance Data Helper) returnerar ett värde av typen PDH_STATUS. Om funktionen lyckas är returvärdet ERROR_SUCCESS. Annars returnerar funktionen en systemfelkod eller en PDH-felkod. Om du vill hämta beskrivningstexten för felet i ditt program använder du funktionen FormatMessage enligt följande exempel.

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

För datainsamlings- och formateringsfunktioner är det viktigt att komma ihåg att funktionens returvärde anger funktionsanropets framgång eller fel och inte nödvändigtvis räknardata. Kontrollera alltid CStatus medlem av räknarvärdet som returneras för att säkerställa att de data som returneras är giltiga innan du använder det. Om värdet för CStatus-medlemsvariabeln inte anger framgång, ska du inte använda datan.

Följande tabell innehåller en lista över felkoder som är specifika för PDH. Dessa värden definieras i pdhmsg.h-huvudfilen.