Fungsi panggilan balik BFFCALLBACK (shlobj_core.h)

Artikel
08/26/2023

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.

Catatan Hanya versi Unicode dari pesan ini, DSBM_QUERYINSERTW, yang didukung. DSBM_QUERYINSERTA tidak didukung.

[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.