Fungsi PdhCollectQueryData (pdh.h)

  • Artikel

Mengumpulkan nilai data mentah saat ini untuk semua penghitung dalam kueri yang ditentukan dan memperbarui kode status setiap penghitung.

Sintaks

PDH_FUNCTION PdhCollectQueryData(
  [in, out] PDH_HQUERY hQuery
);

Parameter

[in, out] hQuery

Tangani kueri yang ingin Anda kumpulkan datanya. Fungsi PdhOpenQuery mengembalikan handel ini.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS. Jika tidak, fungsi mengembalikan kode kesalahan sistem atau kode kesalahan PDH.

Berikut ini adalah nilai yang mungkin.

Menampilkan kode Deskripsi
PDH_INVALID_HANDLE
 Handel kueri tidak valid.
PDH_NO_DATA
 Kueri saat ini tidak berisi penghitung apa pun. Kueri mungkin tidak berisi data karena pengguna tidak berjalan dengan token yang ditingkatkan (lihat Dukungan Akses Pengguna Terbatas).

Keterangan

Panggil fungsi ini saat Anda ingin mengumpulkan data penghitung untuk penghitung dalam kueri. PDH menyimpan nilai penghitung mentah untuk koleksi saat ini dan sebelumnya.

Jika Anda ingin mengambil nilai penghitung mentah saat ini, panggil fungsi PdhGetRawCounterValue . Jika Anda ingin menghitung nilai yang dapat ditampilkan untuk nilai penghitung, panggil fungsi PdhGetFormattedCounterValue . Jika jalur penghitung berisi kartubebas untuk nama instans, sebagai gantinya panggil fungsi PdhGetRawCounterArray dan PdhGetFormattedCounterArray .

Ketika PdhCollectQueryData dipanggil untuk data hanya dari satu instans penghitung dan instans penghitung tidak ada, fungsi mengembalikan PDH_NO_DATA. Namun, jika data dari lebih dari satu penghitung dikueri, PdhCollectQueryData dapat mengembalikan ERROR_SUCCESS bahkan jika salah satu instans penghitung belum ada. Ini karena tidak diketahui apakah instans penghitung yang ditentukan tidak ada, atau jika akan ada tetapi belum dibuat. Dalam hal ini, panggil PdhGetRawCounterValue atau PdhGetFormattedCounterValue untuk setiap instans penghitung yang menarik untuk menentukan apakah ada.

Berikut ini memperlihatkan sintaks jika memanggil fungsi ini dari Visual Basic.

PdhCollectQueryData(
  ByVal QueryHandle as Long  
)
as Long

Contoh

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

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

PdhGetFormattedCounterValue

PdhGetRawCounterValue