struktur PDH_BROWSE_DLG_CONFIG_A (pdh.h)

Struktur PDH_BROWSE_DLG_CONFIG digunakan oleh fungsi PdhBrowseCounters untuk mengonfigurasi kotak dialog Telusuri Penghitung Kinerja .

Sintaks

typedef struct _BrowseDlgConfig_A {
  DWORD               bIncludeInstanceIndex : 1;
  DWORD               bSingleCounterPerAdd : 1;
  DWORD               bSingleCounterPerDialog : 1;
  DWORD               bLocalCountersOnly : 1;
  DWORD               bWildCardInstances : 1;
  DWORD               bHideDetailBox : 1;
  DWORD               bInitializePath : 1;
  DWORD               bDisableMachineSelection : 1;
  DWORD               bIncludeCostlyObjects : 1;
  DWORD               bShowObjectBrowser : 1;
  DWORD               bReserved : 22;
  HWND                hWndOwner;
  LPSTR               szDataSource;
  LPSTR               szReturnPathBuffer;
  DWORD               cchReturnPathLength;
  CounterPathCallBack pCallBack;
  DWORD_PTR           dwCallBackArg;
  PDH_STATUS          CallBackStatus;
  DWORD               dwDefaultDetailLevel;
  LPSTR               szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_A, *PPDH_BROWSE_DLG_CONFIG_A;

Anggota

bIncludeInstanceIndex

Jika bendera ini TRUE, kotak dialog menyertakan nomor indeks untuk nama instans duplikat. Misalnya, jika ada dua instans cmd, daftar instans akan berisi cmd dan cmd#1. Jika bendera ini FALSE, nama instans duplikat tidak akan berisi nomor indeks.

bSingleCounterPerAdd

Jika bendera ini TRUE, dialog hanya mengembalikan satu penghitung. Jika bendera ini FALSE, dialog dapat mengembalikan beberapa pilihan, dan pilihan kartubebas diizinkan. Penghitung yang dipilih dikembalikan sebagai string MULTI_SZ.

bSingleCounterPerDialog

Jika bendera ini TRUE, kotak dialog menggunakan tombol OK dan Batal. Dialog kembali saat pengguna mengklik salah satu tombol. Jika bendera ini FALSE, kotak dialog menggunakan tombol Tambahkan dan Tutup. Kotak dialog ditutup saat pengguna mengklik tombol Tutup. Tombol Tambahkan dapat diklik beberapa kali. Tombol Tambahkan menimpa item yang dipilih sebelumnya dengan item yang saat ini dipilih.

bLocalCountersOnly

Jika bendera ini TRUE, kotak dialog memungkinkan pengguna memilih penghitung hanya dari komputer lokal (jalur tidak akan berisi nama komputer). Jika bendera ini FALSE, pengguna dapat menentukan komputer untuk memilih penghitung. Nama komputer akan mengawali jalur penghitung kecuali pengguna memilih Gunakan penghitung komputer lokal.

bWildCardInstances

Jika bendera ini TRUE dan pengguna memilih Semua instans, jalur penghitung akan menyertakan karakter kartubebas untuk bidang instans.

Jika bendera ini FALSE, dan pengguna memilih Semua instans, semua instans yang saat ini ditemukan untuk objek tersebut akan dikembalikan dalam string MULTI_SZ.

bHideDetailBox

Jika bendera ini TRUE, ini akan menghapus tingkat Detail dari kotak dialog sehingga pengguna tidak dapat mengubah tingkat detail penghitung yang ditampilkan dalam kotak dialog. Tingkat detail akan diperbaiki ke nilai anggota dwDefaultDetailLevel .

Jika bendera ini FALSE, ini menampilkan tingkat Detail dalam kotak dialog, memungkinkan pengguna untuk mengubah tingkat detail penghitung yang ditampilkan.

Perhatikan bahwa penghitung yang ditampilkan adalah penghitung yang tingkat detailnya kurang dari atau sama dengan pemilihan tingkat detail saat ini. Memilih tingkat detail Wizard akan menampilkan semua penghitung dan objek.

bInitializePath

Jika bendera ini TRUE, dialog menyoroti penghitung dan objek yang ditentukan dalam szReturnPathBuffer saat kotak dialog pertama kali ditampilkan, alih-alih menggunakan penghitung dan objek default yang ditentukan oleh komputer.

Jika bendera ini FALSE, ini memilih penghitung dan objek awal menggunakan penghitung default dan informasi objek yang dikembalikan oleh komputer.

bDisableMachineSelection

Jika bendera ini TRUE, pengguna tidak dapat memilih komputer dari Pilih penghitung dari komputer.

Jika bendera ini FALSE, pengguna dapat memilih komputer dari Pilih penghitung dari komputer. Ini adalah nilai default. Daftar ini hanya berisi komputer lokal kecuali Anda memanggil PdhConnectMachine untuk tersambung ke komputer lain terlebih dahulu.

bIncludeCostlyObjects

Jika bendera ini TRUE, daftar penghitung juga akan berisi data yang mahal—yaitu, data yang memerlukan waktu prosesor atau overhead memori yang relatif besar untuk dikumpulkan.

Jika bendera ini FALSE, daftar tidak akan berisi penghitung yang mahal. Ini adalah nilai default.

bShowObjectBrowser

Jika bendera ini TRUE, dialog hanya mencantumkan objek performa. Saat pengguna memilih objek, dialog mengembalikan jalur penghitung yang menyertakan karakter objek dan kartubebas untuk nama instans dan penghitung jika objek adalah objek beberapa instans. Misalnya, jika objek "Proses" dipilih, dialog mengembalikan string "\Process(*)*". Jika objek adalah objek instans tunggal, jalur berisi karakter kartubebas hanya untuk penghitung. Misalnya, "\System*". Anda kemudian dapat meneruskan jalur ke PdhExpandWildCardPath untuk mengambil daftar jalur aktual untuk objek.

bReserved

hWndOwner

Tangani jendela untuk memiliki dialog. Jika NULL, pemiliknya adalah desktop.

szDataSource

Penunjuk ke string yang dihentikan null yang menentukan nama file log tempat daftar penghitung diambil. Jika NULL, daftar penghitung diambil dari komputer lokal (atau komputer jarak jauh jika ditentukan).

szReturnPathBuffer

Penunjuk ke MULTI_SZ yang berisi jalur penghitung yang dipilih.

Jika bInitializePathTRUE, Anda dapat menggunakan anggota ini untuk menentukan jalur penghitung yang komponennya digunakan untuk menyoroti entri dalam daftar komputer, objek, penghitung, dan instans saat dialog pertama kali ditampilkan.

cchReturnPathLength

Ukuran buffer szReturnPathBuffer , dalam TCHAR. Jika fungsi panggilan balik merealokasi buffer baru, fungsi tersebut juga harus memperbarui nilai ini.

pCallBack

Arahkan ke fungsi panggilan balik yang memproses pilihan pengguna. Untuk informasi selengkapnya, lihat CounterPathCallBack.

dwCallBackArg

Nilai yang ditentukan penelepon yang diteruskan ke fungsi panggilan balik.

CallBackStatus

Pada entri ke fungsi panggilan balik, anggota ini berisi status buffer jalur. Saat keluar, fungsi panggilan balik menetapkan nilai status yang dihasilkan dari pemrosesan.

Jika buffer terlalu kecil untuk memuat pilihan saat ini, dialog mengatur nilai ini ke PDH_MORE_DATA. Jika nilai ini ERROR_SUCCESS, maka anggota szReturnPathBuffer berisi jalur penghitung atau daftar jalur penghitung yang valid.

Jika fungsi panggilan balik merealokasi buffer baru, itu harus mengatur anggota ini ke PDH_RETRY sehingga dialog akan mencoba memuat buffer dengan jalur yang dipilih dan memanggil fungsi panggilan balik lagi.

Jika beberapa kesalahan lain terjadi, maka fungsi panggilan balik harus mengembalikan nilai status kesalahan PDH yang sesuai.

dwDefaultDetailLevel

Tingkat detail default untuk ditampilkan dalam daftar Tingkat detail jika bHideDetailBoxadalah FALSE. Jika bHideDetailBoxTRUE, dialog menggunakan nilai ini untuk memfilter penghitung kinerja dan objek yang ditampilkan. Anda dapat menentukan satu atau beberapa nilai berikut:

Tingkat detail	Makna
PERF_DETAIL_NOVICE	Pengguna pemula dapat memahami data penghitung.
PERF_DETAIL_ADVANCED	Data penghitung disediakan untuk pengguna tingkat lanjut.
PERF_DETAIL_EXPERT	Data penghitung disediakan untuk pengguna ahli.
PERF_DETAIL_WIZARD	Data penghitung disediakan untuk perancang sistem.

szDialogBoxCaption

Penunjuk ke string yang dihentikan null yang menentukan caption opsional untuk ditampilkan di bilah caption kotak dialog. Jika anggota ini NULL, caption akan menjadi Telusuri Penghitung Kinerja.

Keterangan

Setiap kali tombol Tambahkan diklik, buffer szReturnPathBuffer berisi penghitung yang dipilih dan fungsi panggilan balik pCallBack dipanggil. Fungsi panggilan balik harus memanggil fungsi PdhAddCounter untuk setiap penghitung di buffer.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	pdh.h

Lihat juga

CounterPathCallBack

PdhAddCounter

PdhBrowseCounters