Fungsi PdhSetQueryTimeRange (pdh.h)

Membatasi sampel yang dapat Anda baca dari file log ke sampel dalam rentang waktu yang ditentukan, secara inklusif.

Sintaks

PDH_FUNCTION PdhSetQueryTimeRange(
  [in] PDH_HQUERY     hQuery,
  [in] PPDH_TIME_INFO pInfo
);

Parameter

[in] hQuery

Menangani kueri. Fungsi PdhOpenQuery mengembalikan handel ini.

[in] pInfo

Struktur PDH_TIME_INFO yang menentukan rentang waktu. Tentukan waktu sebagai waktu file lokal. Waktu akhir harus lebih besar dari waktu mulai. Anda dapat menentukan 0 untuk waktu mulai dan nilai maksimum 64-bit untuk waktu akhir jika Anda ingin membaca semua rekaman.

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_HANDLE	Handel kueri tidak valid.
PDH_INVALID_ARGUMENT	Nilai rentang waktu akhir harus lebih besar dari nilai rentang waktu mulai.

Keterangan

Ketika akhir rentang waktu yang ditentukan atau akhir file log tercapai, fungsi PdhCollectQueryData akan mengembalikan PDH_NO_MORE_DATA.

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

PdhCollectQueryData

PdhGetDataSourceTimeRange

PdhOpenQuery