Fungsi PdhGetDataSourceTimeRangeA (pdh.h)

Menentukan rentang waktu, jumlah entri, dan, jika berlaku, ukuran buffer yang berisi data performa dari sumber input yang ditentukan.

Untuk menggunakan handel ke sumber data, gunakan fungsi PdhGetDataSourceTimeRangeH .

Sintaks

PDH_FUNCTION PdhGetDataSourceTimeRangeA(
  [in]  LPCSTR         szDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Parameter

[in] szDataSource

String yang dihentikan null yang menentukan nama file log tempat informasi rentang waktu diambil.

[out] pdwNumEntries

Jumlah struktur dalam buffer pInfo . Fungsi ini mengumpulkan informasi hanya untuk satu rentang waktu, sehingga nilainya biasanya 1, atau nol jika terjadi kesalahan.

[out] pInfo

Struktur PDH_TIME_INFO yang menerima rentang waktu.

[in] pdwBufferSize

Ukuran struktur PDH_TIME_INFO , dalam byte.

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_ARGUMENT
Parameter tidak valid atau salah diformat.
PDH_INVALID_HANDLE
Handel penghitung tidak valid.
PDH_DATA_SOURCE_IS_REAL_TIME
Sumber data saat ini adalah sumber data real-time.

Keterangan

Catatan

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

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

PdhGetDataSourceTimeRangeH

PdhSetQueryTimeRange