Fehlercodes des Leistungsdaten-Hilfsprogramms

Alle PDH-Funktionen (Performance Data Helper) geben einen Wert vom Typ PDH_STATUS zurück. Wenn die Funktion erfolgreich ist, ist ERROR_SUCCESSder Rückgabewert . Andernfalls gibt die Funktion einen Systemfehlercode oder einen PDH-Fehlercode zurück. Verwenden Sie die FormatMessage-Funktion , wie im folgenden Beispiel gezeigt, um den Beschreibungstext für den Fehler in Ihrer Anwendung abzurufen.

#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 Datensammlungs- und Formatierungsfunktionen ist es wichtig, sich daran zu erinnern, dass der Rückgabewert der Funktion den Erfolg oder Fehler des Funktionsaufrufs angibt und nicht unbedingt den der Zählerdaten. Überprüfen Sie immer den CStatus-Member des zurückgegebenen Zählerwerts, um sicherzustellen, dass die zurückgegebenen Daten gültig sind, bevor Sie ihn verwenden. Wenn der Wert des CStatus-Members keinen Erfolg anzeigt, verwenden Sie die Daten nicht.

Die folgende Tabelle enthält eine Liste der Fehlercodes, die für PDH spezifisch sind. Diese Werte werden in der pdhmsg.h Headerdatei definiert.