Funzione di callback BFFCALLBACK (shlobj_core.h)
La funzione BFFCallBack è una funzione di callback definita dall'applicazione che riceve le notifiche degli eventi dalla finestra di dialogo del browser del contenitore Active Directory Domain Services. Un puntatore a questa funzione viene fornito alla finestra di dialogo del browser contenitore nel membro pfnCallback della struttura DSBROWSEINFO quando viene chiamata la funzione DsBrowseForContainer . BFFCallBack è un segnaposto per il nome della funzione definita dall'applicazione.
Sintassi
BFFCALLBACK Bffcallback;
int Bffcallback(
[in] HWND hwnd,
[in] UINT uMsg,
[in] LPARAM lParam,
[in] LPARAM lpData
)
{...}
Parametri
[in] hwnd
Contiene l'handle di finestra della finestra di dialogo sfoglia. Questo handle viene usato per inviare messaggi alla finestra di dialogo Browse usando la funzione SendMessage .
La finestra di dialogo del browser contenitore gestisce i messaggi seguenti.
BFFM_ENABLEOK
Questo messaggio abilita o disabilita il pulsante di comando OK nella finestra di dialogo.
Il wParam di questo messaggio contiene un valore booleano che, se zero, disabilita il pulsante di comando OK . Se wParam è diverso da zero, il pulsante di comando OK è abilitato. Per impostazione predefinita, il pulsante di comando OK è abilitato.
Il valore restituito per questo messaggio non viene utilizzato.
BFFM_SETSELECTION
Questo messaggio seleziona un elemento nella finestra di dialogo.
LParam di questo messaggio è un puntatore a una stringa TCHAR contenente il valore ADsPath dell'elemento da selezionare. Anche se sono presenti versioni ANSI e Unicode di questo messaggio, entrambe le versioni accettano un puntatore a una stringa Unicode.
Il valore restituito per questo messaggio non viene utilizzato.
[in] uMsg
Specifica uno dei messaggi di esplorazione seguenti.
BFFM_INITIALIZED
Questa notifica viene inviata dopo l'inizializzazione della finestra di dialogo.
lParam non viene usato.
Il valore restituito da questa notifica viene ignorato.
BFFM_SELCHANGED
Questa notifica viene inviata dopo la modifica della selezione nella finestra di dialogo.
lParam è un puntatore a una stringa Unicode che contiene il percorso ADsPath dell'elemento appena selezionato.
Il valore restituito da questa notifica viene ignorato.
DSBM_CHANGEIMAGESTATE
Riservato.
DSBM_CONTEXTMENU
Questa notifica viene inviata quando la finestra di dialogo riceve un messaggio WM_CONTEXTMENU .
lParam è il valore wParam passato con il messaggio WM_CONTEXTMENU .
Il valore restituito da questa notifica viene ignorato.
DSBM_HELP
Questa notifica viene inviata quando la finestra di dialogo riceve un messaggio WM_HELP .
lParam è il valore lParam passato con il messaggio WM_HELP .
Il valore restituito da questa notifica viene ignorato.
DSBM_QUERYINSERT
Questa notifica viene inviata prima dell'inserimento di ogni oggetto contenitore nell'albero. L'applicazione può usare questa notifica per modificare il contenuto della finestra di dialogo.
lParam è un puntatore a una struttura DSBITEM che contiene dati sull'elemento inserito. Alcuni membri di questa struttura, ad esempio szDisplayName, possono essere modificati durante questa notifica per modificare la modalità di visualizzazione degli elementi.
Restituisce un valore diverso da zero da questa notifica se i dati nella struttura DSBITEM cambiano. Restituisce zero se l'ora deve essere inserita invariata.
[in] lParam
Il valore e il significato di questo parametro sono determinati dalla notifica ricevuta. Per altre informazioni, vedere le descrizioni dei messaggi di notifica nel parametro uMsg .
[in] lpData
Contiene un puntatore alla struttura DSBROWSEINFO passata alla funzione DsBrowseForContainer . Questo vale per tutti i messaggi di notifica.
Valore restituito
nessuno
Osservazioni
I valori dei messaggi DSBM_* sono definiti in Dsclient.h.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | shlobj_core.h |