Fungsi PdhOpenQueryA (pdh.h)

Artikel
08/25/2023

Membuat kueri baru yang digunakan untuk mengelola pengumpulan data performa.

Untuk menggunakan handel ke sumber data, gunakan fungsi PdhOpenQueryH .

Sintaks

PDH_FUNCTION PdhOpenQueryA(
  [in]  LPCSTR     szDataSource,
  [in]  DWORD_PTR  dwUserData,
  [out] PDH_HQUERY *phQuery
);

Parameter

[in] szDataSource

String yang dihentikan null yang menentukan nama file log untuk mengambil data performa. Jika NULL, data performa dikumpulkan dari sumber data real-time.

[in] dwUserData

Nilai yang ditentukan pengguna untuk dikaitkan dengan kueri ini. Untuk mengambil data pengguna nanti, panggil PdhGetCounterInfo dan akses anggota dwQueryUserDatadari PDH_COUNTER_INFO.

[out] phQuery

Menangani kueri. Anda menggunakan handel ini dalam panggilan berikutnya.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

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

Keterangan

Catatan

Header pdh.h mendefinisikan PdhOpenQuery 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


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

PdhSetDefaultRealTimeDataSource