Fungsi PdhGetRawCounterArrayA (pdh.h)

Artikel
11/20/2024

Mengembalikan array nilai mentah dari penghitung yang ditentukan. Gunakan fungsi ini saat Anda ingin mengambil nilai penghitung mentah penghitung yang berisi karakter kartubebas untuk nama instans.

Sintaksis

PDH_FUNCTION PdhGetRawCounterArrayA(
  [in]      PDH_HCOUNTER            hCounter,
  [in, out] LPDWORD                 lpdwBufferSize,
  [out]     LPDWORD                 lpdwItemCount,
  [out]     PPDH_RAW_COUNTER_ITEM_A ItemBuffer
);

Parameter

[in] hCounter

Menangani penghitung yang nilai instans mentahnya saat ini ingin Anda ambil. Fungsi PdhAddCounter mengembalikan handel ini.

[in, out] lpdwBufferSize

Ukuran buffer ItemBuffer, dalam byte. Jika nol pada input, fungsi mengembalikan PDH_MORE_DATA dan mengatur parameter ini ke ukuran buffer yang diperlukan. Jika buffer lebih besar dari ukuran yang diperlukan, fungsi mengatur parameter ini ke ukuran buffer aktual yang digunakan. Jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan, Anda tidak boleh mengandalkan ukuran yang dikembalikan untuk merealokasi buffer.

[out] lpdwItemCount

Jumlah nilai penghitung mentah dalam buffer ItemBuffer.

[out] ItemBuffer

Buffer yang dialokasikan pemanggil yang menerima array struktur PDH_RAW_COUNTER_ITEM; struktur berisi nilai penghitung instans mentah. Atur ke NULL jika lpdwBufferSize adalah nol.

Mengembalikan nilai

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.

Mengembalikan kode	Deskripsi
PDH_MORE_DATA	Buffer ItemBuffer tidak cukup besar untuk memuat nama objek. Nilai pengembalian ini diharapkan jika lpdwBufferSize nol pada input. Jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan, Anda tidak boleh mengandalkan ukuran yang dikembalikan untuk merealokasi buffer.
PDH_INVALID_ARGUMENT	Parameter tidak valid atau salah diformat. Misalnya, pada beberapa rilis, Anda dapat menerima kesalahan ini jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan.
PDH_INVALID_HANDLE	Handel penghitung tidak valid.

Komentar

Anda harus memanggil fungsi ini dua kali, pertama kali untuk mendapatkan ukuran buffer yang diperlukan (atur ItemBuffer ke NULL dan lpdwBufferSize ke 0), dan kedua kalinya untuk mendapatkan data.

Data untuk penghitung dikunci selama panggilan ke PdhGetRawCounterArray untuk mencegah perubahan apa pun selama pemrosesan panggilan.

Nota

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

PDH_RAW_COUNTER_ITEM

PdhCalculateCounterFromRawValue

PdhGetFormattedCounterArray

PdhGetFormattedCounterValue

Bagikan melalui