Fungsi PdhAddCounterA (pdh.h)

Artikel
03/08/2023

Menambahkan penghitung yang ditentukan ke kueri.

Sintaks

PDH_FUNCTION PdhAddCounterA(
  [in]  PDH_HQUERY   hQuery,
  [in]  LPCSTR       szFullCounterPath,
  [in]  DWORD_PTR    dwUserData,
  [out] PDH_HCOUNTER *phCounter
);

Parameter

[in] hQuery

Tangani ke kueri yang ingin Anda tambahkan penghitungnya. Handel ini dikembalikan oleh fungsi PdhOpenQuery .

[in] szFullCounterPath

String yang dihentikan null yang berisi jalur penghitung. Untuk detail tentang format jalur penghitung, lihat Menentukan Jalur Penghitung. Panjang maksimum jalur penghitung adalah PDH_MAX_COUNTER_PATH.

[in] dwUserData

Nilai yang ditentukan pengguna. Nilai ini menjadi bagian dari informasi penghitung. Untuk mengambil nilai ini nanti, panggil fungsi PdhGetCounterInfo dan akses anggota dwUserData dari struktur PDH_COUNTER_INFO .

[out] phCounter

Tangani ke penghitung yang ditambahkan ke kueri. Anda mungkin perlu mereferensikan handel ini dalam panggilan berikutnya.

Nilai kembali

Mengembalikan ERROR_SUCCESS jika fungsi berhasil.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem atau kode kesalahan PDH. Berikut ini adalah nilai yang mungkin.

Menampilkan kode	Deskripsi
PDH_CSTATUS_BAD_COUNTERNAME	Jalur penghitung tidak dapat diurai atau ditafsirkan.
PDH_CSTATUS_NO_COUNTER	Tidak dapat menemukan penghitung yang ditentukan pada komputer atau dalam file log.
PDH_CSTATUS_NO_COUNTERNAME	Jalur penghitung kosong.
PDH_CSTATUS_NO_MACHINE	Jalur tidak memuat nama komputer, dan fungsi tidak dapat mengambil nama komputer lokal.
PDH_CSTATUS_NO_OBJECT	Tidak dapat menemukan objek yang ditentukan pada komputer atau dalam file log.
PDH_FUNCTION_NOT_FOUND	Tidak dapat menentukan fungsi perhitungan yang akan digunakan untuk penghitung ini.
PDH_INVALID_ARGUMENT	Satu atau beberapa argumen tidak valid.
PDH_INVALID_HANDLE	Handel kueri tidak valid.
PDH_MEMORY_ALLOCATION_FAILURE	Tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikan fungsi.

Keterangan

Jika jalur penghitung berisi karakter kartubebas, semua nama penghitung yang cocok dengan karakter kartubebas ditambahkan ke kueri.

Jika instans penghitung ditentukan yang belum ada, PdhAddCounter tidak melaporkan kondisi kesalahan. Sebaliknya, ia mengembalikan ERROR_SUCCESS. Alasan untuk perilaku ini adalah bahwa tidak diketahui apakah instans penghitung yang tidak ada telah ditentukan atau apakah satu akan ada tetapi belum dibuat.

Untuk menghapus penghitung dari kueri, gunakan fungsi PdhRemoveCounter .

Contoh

Misalnya, lihat Menelusuri Penghitung Kinerja atau Membaca Data Performa dari File Log.

Catatan

Header pdh.h mendefinisikan PdhAddCounter sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	pdh.h
Pustaka	Pdh.lib
DLL	Pdh.dll