Kode Kesalahan Pembantu Data Performa

Semua fungsi Performance Data Helper (PDH) mengembalikan nilai jenis PDH_STATUS. Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS. Jika tidak, fungsi mengembalikan kode kesalahan sistem atau kode kesalahan PDH. Untuk mengambil teks deskripsi untuk kesalahan dalam aplikasi Anda, gunakan fungsi FormatMessage seperti yang ditunjukkan dalam contoh berikut.

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

Untuk fungsi pengumpulan dan pemformatan data, penting untuk diingat bahwa nilai pengembalian fungsi menunjukkan keberhasilan atau kesalahan panggilan fungsi dan belum tentu dari data penghitung. Selalu periksa anggota CStatus dari nilai penghitung yang dikembalikan untuk memastikan bahwa data yang dikembalikan valid sebelum Anda menggunakannya. Jika nilai anggota CStatus tidak menunjukkan keberhasilan, jangan gunakan data.

Tabel berikut ini menyediakan daftar kode kesalahan yang khusus untuk PDH. Nilai-nilai ini didefinisikan dalam pdhmsg.h file header.