Fonction de rappel BFFCALLBACK (shlobj_core.h)

Article
03/15/2023

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.

Note Seule la version Unicode de ce message, DSBM_QUERYINSERTW, est prise en charge. DSBM_QUERYINSERTA n’est pas pris en charge.

[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