Fungsi PdhSetQueryTimeRange (pdh.h)

  • Artikel

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