Fungsi PdhSelectDataSourceA (pdh.h)

Artikel
11/20/2024

Menampilkan jendela dialog yang meminta pengguna untuk menentukan sumber data performa.

Sintaksis

PDH_FUNCTION PdhSelectDataSourceA(
  [in]      HWND    hWndOwner,
  [in]      DWORD   dwFlags,
  [out]     LPSTR   szDataSource,
  [in, out] LPDWORD pcchBufferLength
);

Parameter

[in] hWndOwner

Pemilik jendela dialog. Ini dapat null jika tidak ada pemilik (desktop menjadi pemilik).

[in] dwFlags

Kotak dialog yang akan ditampilkan untuk meminta sumber data. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
PDH_FLAGS_FILE_BROWSER_ONLY	Tampilkan browser file saja. Atur bendera ini saat Anda ingin meminta nama dan lokasi file log saja.
0	Tampilkan kotak dialog pemilihan sumber data. Kotak dialog memungkinkan pengguna memilih data performa dari file log atau sumber real time. Jika pengguna menentukan bahwa data akan dikumpulkan dari file log, browser file ditampilkan bagi pengguna untuk menentukan nama dan lokasi file log.

[out] szDataSource

Buffer yang dialokasikan pemanggil yang menerima string nulldihentikan yang berisi nama file log yang dipilih pengguna. Nama file log dipotong ke ukuran buffer jika buffer terlalu kecil.

Jika pengguna memilih sumber real time, buffer kosong.

[in, out] pcchBufferLength

Ukuran maksimum buffer szDataSource , dalam TCHAR.

Mengembalikan nilai

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.

Mengembalikan kode	Deskripsi
PDH_INVALID_ARGUMENT	Panjang buffer yang diteruskan dalam pcchBufferLength tidak sama dengan panjang aktual buffer szDataSource.
PDH_MEMORY_ALLOCATION_FAILURE	Buffer panjang nol diteruskan dalam parameter szDataSource .

Komentar

Nota

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

PdhIsRealTimeQuery

Bagikan melalui