Fungsi PdhOpenQueryA (pdh.h)

Artikel
11/20/2024

Membuat kueri baru yang digunakan untuk mengelola pengumpulan data performa.

Untuk menggunakan handel ke sumber data, gunakan fungsi PdhOpenQueryH.

Sintaksis

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

Parameter

[in] szDataSource

String null-dihentikan 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 dwQueryUserData anggota PDH_COUNTER_INFO.

[out] phQuery

Tangani ke kueri. Anda menggunakan handel ini dalam panggilan berikutnya.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

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

Komentar

Nota

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

PdhCloseQuery

PdhGetCounterInfo

PdhIsRealTimeQuery

PdhOpenQueryH

PdhSetDefaultRealTimeDataSource

Bagikan melalui