Fungsi panggilan balik BFFCALLBACK (shlobj_core.h)
Fungsi BFFCallBack adalah fungsi panggilan balik yang ditentukan aplikasi yang menerima pemberitahuan peristiwa dari kotak dialog browser kontainer Active Directory Domain Services. Pointer ke fungsi ini disediakan ke kotak dialog browser kontainer di anggota pfnCallback dari struktur DSBROWSEINFO ketika fungsi DsBrowseForContainer dipanggil. BFFCallBack adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.
Sintaks
BFFCALLBACK Bffcallback;
int Bffcallback(
[in] HWND hwnd,
[in] UINT uMsg,
[in] LPARAM lParam,
[in] LPARAM lpData
)
{...}
Parameter
[in] hwnd
Berisi handel jendela kotak dialog telusuri. Handel ini digunakan untuk mengirim pesan ke kotak dialog telusuri menggunakan fungsi SendMessage .
Kotak dialog browser kontainer menangani pesan berikut.
BFFM_ENABLEOK
Pesan ini mengaktifkan atau menonaktifkan tombol perintah OK dalam kotak dialog.
WParam pesan ini berisi nilai Boolean yang, jika nol, menonaktifkan tombol perintah OK. Jika wParam bukan nol, tombol perintah OK diaktifkan. Secara default, tombol perintah OK diaktifkan.
Nilai yang dikembalikan untuk pesan ini tidak digunakan.
BFFM_SETSELECTION
Pesan ini memilih item dalam kotak dialog.
lParam pesan ini adalah penunjuk ke string TCHAR yang berisi ADsPath item yang akan dipilih. Meskipun ada versi ANSI dan Unicode dari pesan ini, kedua versi mengambil penunjuk ke string Unicode.
Nilai yang dikembalikan untuk pesan ini tidak digunakan.
[in] uMsg
Menentukan salah satu pesan telusuri berikut ini.
BFFM_INITIALIZED
Pemberitahuan ini dikirim setelah kotak dialog diinisialisasi.
lParam tidak digunakan.
Nilai yang dikembalikan dari pemberitahuan ini diabaikan.
BFFM_SELCHANGED
Pemberitahuan ini dikirim setelah pilihan dalam kotak dialog diubah.
lParam adalah penunjuk ke string Unicode yang berisi ADsPath dari item yang baru dipilih.
Nilai yang dikembalikan dari pemberitahuan ini diabaikan.
DSBM_CHANGEIMAGESTATE
Dicadangkan.
DSBM_CONTEXTMENU
Pemberitahuan ini dikirim ketika kotak dialog menerima pesan WM_CONTEXTMENU .
lParam adalah nilai wParam yang diteruskan dengan pesan WM_CONTEXTMENU .
Nilai yang dikembalikan dari pemberitahuan ini diabaikan.
DSBM_HELP
Pemberitahuan ini dikirim ketika kotak dialog menerima pesan WM_HELP .
lParam adalah nilai lParam yang diteruskan dengan pesan WM_HELP .
Nilai yang dikembalikan dari pemberitahuan ini diabaikan.
DSBM_QUERYINSERT
Pemberitahuan ini dikirim sebelum setiap objek kontainer dimasukkan ke dalam pohon. Aplikasi dapat menggunakan pemberitahuan ini untuk mengubah konten kotak dialog.
lParam adalah penunjuk ke struktur DSBITEM yang berisi data tentang item yang disisipkan. Beberapa anggota struktur ini, seperti szDisplayName, dapat dimodifikasi selama pemberitahuan ini untuk mengubah cara item ditampilkan.
Mengembalikan nilai bukan nol dari pemberitahuan ini jika data dalam struktur DSBITEM berubah. Mengembalikan nol jika waktu harus dimasukkan tidak berubah.
[in] lParam
Nilai dan arti parameter ini ditentukan oleh pemberitahuan yang diterima. Untuk informasi selengkapnya, lihat deskripsi pesan pemberitahuan di bawah parameter uMsg .
[in] lpData
Berisi pointer ke struktur DSBROWSEINFO yang diteruskan ke fungsi DsBrowseForContainer . Ini berlaku untuk semua pesan pemberitahuan.
Nilai kembali
Tidak ada
Keterangan
Nilai pesan DSBM_* ditentukan dalam Dsclient.h.
Persyaratan
Klien minimum yang didukung | Windows Vista |
Server minimum yang didukung | Windows Server 2008 |
Target Platform | Windows |
Header | shlobj_core.h |