Codes d’erreur de l’application d’assistance pour les données de performances

Toutes les fonctions d’assistance des données de performances (PDH) retournent une valeur de type PDH_STATUS. Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Sinon, la fonction retourne un code d’erreur système ou un code d’erreur PDH. Pour récupérer le texte de description de l’erreur dans votre application, utilisez la fonction FormatMessage , comme indiqué dans l’exemple suivant.

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

Pour les fonctions de collecte et de mise en forme de données, il est important de se rappeler que la valeur de retour de la fonction indique la réussite ou l’erreur de l’appel de fonction et pas nécessairement celle des données de compteur. Toujours case activée le membre CStatus de la valeur de compteur retournée pour vous assurer que les données retournées sont valides avant de les utiliser. Si la valeur du membre CStatus n’indique pas la réussite, n’utilisez pas les données.

Le tableau suivant fournit une liste de codes d’erreur spécifiques à PDH. Ces valeurs sont définies dans le fichier d’en-tête pdhmsg.h .