Fungsi PdhAddCounterW (pdh.h)

Artikel
11/20/2024

Menambahkan penghitung yang ditentukan ke kueri.

Sintaksis

PDH_FUNCTION PdhAddCounterW(
  [in]  PDH_HQUERY   hQuery,
  [in]  LPCWSTR      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 null-terminated 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 dwUserData anggota struktur PDH_COUNTER_INFO.

[out] phCounter

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

Mengembalikan nilai

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.

Mengembalikan 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.

Komentar

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 Penjelajahan Penghitung Kinerja atau Membaca Data Performa dari File Log.

Nota

Header pdh.h mendefinisikan PdhAddCounter sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

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

Lihat juga

PdhAddEnglishCounter

PdhBrowseCounters

PdhMakeCounterPath

PdhOpenQuery

PdhRemoveCounter

Bagikan melalui