Mengonfigurasi fungsi panggilan balik

Fungsi Konfigurasi mengonfigurasi pakar dalam DLL ahli.

Pakar harus mengimplementasikan fungsi Konfigurasi . Saat panggilan fungsi diterima, pakar menampilkan kotak dialog yang memungkinkan pengguna mengubah item yang dapat dikonfigurasi.

Sintaks

BOOL WINAPI Configure(
  _In_    HEXPERTKEY         hExpertKey,
  _Inout_ PEXPERTCONFIG      *ppConfig,
  _In_    PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_    DWORD              StartupFlags,
  _In_    HWND               hWnd
);

Parameter

hExpertKey [in]

Pengidentifikasi ahli unik.

Pengidentifikasi unik diteruskan kembali pada semua fungsi Monitor Jaringan khusus ahli. Ketahuilah bahwa pengidentifikasi mungkin bukan kunci ahli yang sama dengan yang diteruskan ke fungsi Jalankan . Jangan menyimpan kunci ahli dari panggilan Konfigurasi .

ppConfig [in, out]

Penunjuk ke penunjuk ke struktur EXPERTCONFIG saat masuk.

Setelah berhasil keluar, struktur EXPERTCONFIG yang dirujuk berisi data konfigurasi baru.

pExpertStartupInfo [in]

Penunjuk ke elemen tangkapan dengan fokus saat ahli dimulai.

StartupFlags [in]

Bendera yang menunjukkan bagaimana pakar harus menggunakan parameter pExpertStartupInfo . Satu-satunya bendera yang ditentukan adalah EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA. Bendera menunjukkan bahwa pakar akan menggunakan parameter pExpertStartupInfo daripada parameter ppConfig yang diteruskan. Biasanya, Anda mengatur bendera saat memulai pakar dari menu konteks.

hWnd [in]

Handel ke jendela induk. Gunakan handel untuk membuka kotak dialog.

Nilai kembali

Jika fungsi berhasil (yaitu, jika konfigurasi saat ini ada), nilai yang dikembalikan adalah TRUE.

Jika fungsi tidak berhasil, nilai yang dikembalikan adalah FALSE.

Keterangan

Monitor Jaringan memanggil fungsi Konfigurasi dengan konfigurasi pakar saat ini, jika ada. Pakar menampilkan kotak dialog, yang dengannya Anda dapat mengubah item yang dapat dikonfigurasi.

Ketika ppConfig diteruskan dan Monitor Jaringan tidak memiliki konfigurasi yang disimpan untuk pakar yang ditentukan, nilai parameter dapat berupa NULL. Dalam hal ini, fungsi Konfigurasi mengasumsikan nilai default yang dikodekan secara permanen (atau, menggunakan informasi startup) untuk membuka kotak dialog.

Data konfigurasi juga bisa NULL saat fungsi Konfigurasi kembali, dan NULL diteruskan. Situasi ini terjadi ketika Monitor Jaringan tidak memiliki default tersimpan, dan pengguna menekan Batal.

Awal struktur data EXPERTCONFIG mencakup bagian Privat yang menyimpan informasi ukuran struktur. Ukuran struktur EXPERTCONFIG harus mencakup panjang DWORD yang dipesan yang muncul di awal struktur. Misalnya, jika data konfigurasi Anda memerlukan 20 byte ruang penyimpanan, alokasikan 24 byte untuk menyimpan data. Jika ppConfig adalah NULL, fungsi Konfigurasi memanggil fungsi ExpertAllocMemory untuk mengalokasikan konfigurasi baru yang berukuran benar. Jika buffer tidak cukup untuk menyimpan data ahli, ahli harus memanggil fungsi ExpertReallocMemory .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Netmon.h