BFFCALLBACK-Rückruffunktion (shlobj_core.h)
Die BFFCallBack-Funktion ist eine anwendungsdefinierte Rückruffunktion, die Ereignisbenachrichtigungen aus dem Dialogfeld Active Directory Domain Services Containerbrowser empfängt. Ein Zeiger auf diese Funktion wird auf das Dialogfeld container browser im pfnCallback-Member der DSBROWSEINFO-Struktur bereitgestellt, wenn die DsBrowseForContainer-Funktion aufgerufen wird. BFFCallBack ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
Syntax
BFFCALLBACK Bffcallback;
int Bffcallback(
[in] HWND hwnd,
[in] UINT uMsg,
[in] LPARAM lParam,
[in] LPARAM lpData
)
{...}
Parameter
[in] hwnd
Enthält das Fensterhandle des Dialogfelds "Durchsuchen". Dieses Handle wird verwendet, um Nachrichten mithilfe der SendMessage-Funktion an das Dialogfeld "Durchsuchen" zu senden.
Das Dialogfeld "Containerbrowser" verarbeitet die folgenden Meldungen.
BFFM_ENABLEOK
Diese Meldung aktiviert oder deaktiviert die Befehlsschaltfläche OK im Dialogfeld.
Die wParam dieser Nachricht enthält einen booleschen Wert, der bei Null die Befehlsschaltfläche OK deaktiviert. Wenn wParam ungleich null ist, ist die Befehlsschaltfläche OK aktiviert. Standardmäßig ist die Befehlsschaltfläche OK aktiviert.
Der Rückgabewert für diese Nachricht wird nicht verwendet.
BFFM_SETSELECTION
Diese Meldung wählt ein Element im Dialogfeld aus.
Die lParam dieser Nachricht ist ein Zeiger auf eine TCHAR-Zeichenfolge , die den ADsPath des auszuwählenden Elements enthält. Obwohl es ANSI- und Unicode-Versionen dieser Nachricht gibt, verwenden beide Versionen einen Zeiger auf eine Unicode-Zeichenfolge.
Der Rückgabewert für diese Nachricht wird nicht verwendet.
[in] uMsg
Gibt eine der folgenden Browsenachrichten an.
BFFM_INITIALIZED
Diese Benachrichtigung wird gesendet, nachdem das Dialogfeld initialisiert wurde.
lParam wird nicht verwendet.
Der Rückgabewert aus dieser Benachrichtigung wird ignoriert.
BFFM_SELCHANGED
Diese Benachrichtigung wird gesendet, nachdem die Auswahl im Dialogfeld geändert wurde.
lParam ist ein Zeiger auf eine Unicode-Zeichenfolge, die den ADsPath des neu ausgewählten Elements enthält.
Der Rückgabewert aus dieser Benachrichtigung wird ignoriert.
DSBM_CHANGEIMAGESTATE
Reserviert.
DSBM_CONTEXTMENU
Diese Benachrichtigung wird gesendet, wenn das Dialogfeld eine WM_CONTEXTMENU Nachricht empfängt.
lParam ist der wParam-Wert , der mit der WM_CONTEXTMENU Nachricht übergeben wird.
Der Rückgabewert aus dieser Benachrichtigung wird ignoriert.
DSBM_HELP
Diese Benachrichtigung wird gesendet, wenn das Dialogfeld eine WM_HELP Nachricht empfängt.
lParam ist der lParam-Wert , der mit der WM_HELP Nachricht übergeben wird.
Der Rückgabewert aus dieser Benachrichtigung wird ignoriert.
DSBM_QUERYINSERT
Diese Benachrichtigung wird gesendet, bevor jedes Containerobjekt in die Struktur eingefügt wird. Die Anwendung kann diese Benachrichtigung verwenden, um den Inhalt des Dialogfelds zu ändern.
lParam ist ein Zeiger auf eine DSBITEM-Struktur , die Daten über das eingefügte Element enthält. Einige Member dieser Struktur, z. B. szDisplayName, können während dieser Benachrichtigung geändert werden, um die Anzeige von Elementen zu ändern.
Gibt einen Wert ungleich null aus dieser Benachrichtigung zurück, wenn sich Daten in der DSBITEM-Struktur ändern. Gibt null zurück, wenn die Uhrzeit unverändert eingefügt werden soll.
[in] lParam
Der Wert und die Bedeutung dieses Parameters werden durch die empfangene Benachrichtigung bestimmt. Weitere Informationen finden Sie in den Benachrichtigungsbeschreibungen unter dem uMsg-Parameter .
[in] lpData
Enthält einen Zeiger auf die DSBROWSEINFO-Struktur , die an die DsBrowseForContainer-Funktion übergeben wird. Dies gilt für alle Benachrichtigungen.
Rückgabewert
Keine
Bemerkungen
Die DSBM_* -Nachrichtenwerte sind in Dsclient.h definiert.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h |