Fungsi PdhGetRawCounterValue (pdh.h)

Artikel
03/04/2024

Mengembalikan nilai mentah penghitung saat ini.

Sintaks

PDH_FUNCTION PdhGetRawCounterValue(
  [in]  PDH_HCOUNTER     hCounter,
  [out] LPDWORD          lpdwType,
  [out] PPDH_RAW_COUNTER pValue
);

Parameter

[in] hCounter

Tangani penghitung untuk mengambil nilai mentah saat ini. Fungsi PdhAddCounter mengembalikan handel ini.

[out] lpdwType

Menerima jenis penghitung. Untuk daftar jenis penghitung, lihat bagian Jenis Penghitung dari Kit Penyebaran Windows Server 2003. Parameter ini bersifat opsional.

[out] pValue

Struktur PDH_RAW_COUNTER yang menerima nilai penghitung.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

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

Menampilkan kode	Deskripsi
PDH_INVALID_ARGUMENT	Parameter tidak valid atau salah diformat.
PDH_INVALID_HANDLE	Handel penghitung tidak valid.

Keterangan

Data untuk penghitung dikunci (dilindungi) selama panggilan ke PdhGetRawCounterValue untuk mencegah perubahan apa pun selama pemrosesan panggilan.

Jika instans penghitung yang ditentukan tidak ada, fungsi ini akan mengembalikan ERROR_SUCCESS dan anggota CStatus dari struktur PDH_RAW_COUNTER akan berisi PDH_CSTATUS_NO_INSTANCE.

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

Lihat juga

PdhCalculateCounterFromRawValue

PdhCollectQueryData

PdhGetFormattedCounterValue

Bagikan melalui