Codici di errore dell'helper Dati di prestazione

Tutte le funzioni PDH (Performance Data Helper) restituiscono un valore di tipo PDH_STATUS. Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS. In caso contrario, la funzione restituisce un codice di errore di sistema o un codice di errore PDH. Per recuperare il testo della descrizione per l'errore nell'applicazione, usare la funzione FormatMessage come illustrato nell'esempio seguente.

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

Per le funzioni di raccolta dati e formattazione, è importante ricordare che il valore restituito della funzione indica l'esito positivo o negativo della chiamata di funzione e non necessariamente quello dei dati del contatore. Controllare sempre il membro CStatus del valore del contatore restituito per assicurarsi che i dati restituiti siano validi prima di usarli. Se il valore del membro CStatus non indica l'esito positivo, non usare i dati.

Nella tabella seguente viene fornito un elenco di codici di errore specifici per PDH. Questi valori sono definiti nel pdhmsg.h file di intestazione.