BFFCALLBACK-Rückruffunktion (shlobj_core.h)

Artikel
08/26/2023

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.

Hinweis Nur die Unicode-Version dieser Nachricht , DSBM_QUERYINSERTW, wird unterstützt. DSBM_QUERYINSERTA wird nicht unterstützt.

[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