Fonction de rappel BFFCALLBACK (shlobj_core.h)
La fonction BFFCallBack est une fonction de rappel définie par l’application qui reçoit des notifications d’événements à partir de la boîte de dialogue services de domaine Active Directory navigateur de conteneur. Un pointeur vers cette fonction est fourni vers la boîte de dialogue du navigateur de conteneur dans le membre pfnCallback de la structure DSBROWSEINFO lorsque la fonction DsBrowseForContainer est appelée. BFFCallBack est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
BFFCALLBACK Bffcallback;
int Bffcallback(
[in] HWND hwnd,
[in] UINT uMsg,
[in] LPARAM lParam,
[in] LPARAM lpData
)
{...}
Paramètres
[in] hwnd
Contient le handle de fenêtre de la boîte de dialogue Parcourir. Ce handle est utilisé pour envoyer des messages à la boîte de dialogue parcourir à l’aide de la fonction SendMessage .
La boîte de dialogue du navigateur de conteneur gère les messages suivants.
BFFM_ENABLEOK
Ce message active ou désactive le bouton de commande OK dans la boîte de dialogue.
Le wParam de ce message contient une valeur booléenne qui, si zéro, désactive le bouton de commande OK . Si wParam est différent de zéro, le bouton de commande OK est activé. Par défaut, le bouton de commande OK est activé.
La valeur de retour de ce message n’est pas utilisée.
BFFM_SETSELECTION
Ce message sélectionne un élément dans la boîte de dialogue.
L’élément lParam de ce message est un pointeur vers une chaîne TCHAR qui contient l’ADsPath de l’élément à sélectionner. Même s’il existe des versions ANSI et Unicode de ce message, les deux versions prennent un pointeur vers une chaîne Unicode.
La valeur de retour de ce message n’est pas utilisée.
[in] uMsg
Spécifie l’un des messages de navigation suivants.
BFFM_INITIALIZED
Cette notification est envoyée après l’initialisation de la boîte de dialogue.
lParam n’est pas utilisé.
La valeur de retour de cette notification est ignorée.
BFFM_SELCHANGED
Cette notification est envoyée après la modification de la sélection dans la boîte de dialogue.
lParam est un pointeur vers une chaîne Unicode qui contient l’ADsPath de l’élément nouvellement sélectionné.
La valeur de retour de cette notification est ignorée.
DSBM_CHANGEIMAGESTATE
Réservé.
DSBM_CONTEXTMENU
Cette notification est envoyée lorsque la boîte de dialogue reçoit un message WM_CONTEXTMENU .
lParam est la valeur wParam passée avec le message WM_CONTEXTMENU .
La valeur de retour de cette notification est ignorée.
DSBM_HELP
Cette notification est envoyée lorsque la boîte de dialogue reçoit un message WM_HELP .
lParam est la valeur lParam passée avec le message WM_HELP .
La valeur de retour de cette notification est ignorée.
DSBM_QUERYINSERT
Cette notification est envoyée avant l’insertion de chaque objet conteneur dans l’arborescence. L’application peut utiliser cette notification pour modifier le contenu de la boîte de dialogue.
lParam est un pointeur vers une structure DSBITEM qui contient des données sur l’élément inséré. Certains membres de cette structure, tels que szDisplayName, peuvent être modifiés pendant cette notification pour modifier la façon dont les éléments sont affichés.
Retourne une valeur différente de zéro à partir de cette notification si les données de la structure DSBITEM changent. Retourne zéro si l’heure doit être insérée inchangée.
[in] lParam
La valeur et la signification de ce paramètre sont déterminées par la notification reçue. Pour plus d’informations, consultez les descriptions des messages de notification sous le paramètre uMsg .
[in] lpData
Contient un pointeur vers la structure DSBROWSEINFO passée à la fonction DsBrowseForContainer . Cela s’applique à tous les messages de notification.
Valeur de retour
None
Remarques
Les valeurs de message DSBM_* sont définies dans Dsclient.h.
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | shlobj_core.h |