Función de devolución de llamada BFFCALLBACK (shlobj_core.h)

Artículo
03/15/2023

La función BFFCallBack es una función de devolución de llamada definida por la aplicación que recibe notificaciones de eventos del cuadro de diálogo del explorador de contenedores de Servicios de dominio de Active Directory. Se proporciona un puntero a esta función al cuadro de diálogo del explorador de contenedores en el miembro pfnCallback de la estructura DSBROWSEINFO cuando se llama a la función DsBrowseForContainer . BFFCallBack es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

BFFCALLBACK Bffcallback;

int Bffcallback(
  [in] HWND hwnd,
  [in] UINT uMsg,
  [in] LPARAM lParam,
  [in] LPARAM lpData
)
{...}

Parámetros

[in] hwnd

Contiene el identificador de ventana del cuadro de diálogo Examinar. Este identificador se usa para enviar mensajes al cuadro de diálogo Examinar mediante la función SendMessage .

El cuadro de diálogo del explorador de contenedores controla los siguientes mensajes.

BFFM_ENABLEOK

Este mensaje habilita o deshabilita el botón Aceptar comando en el cuadro de diálogo.

El wParam de este mensaje contiene un valor booleano que, si es cero, deshabilita el botón de comando Aceptar . Si wParam no es cero, el botón de comando Aceptar está habilitado. De forma predeterminada, el botón de comando Aceptar está habilitado.

No se usa el valor devuelto de este mensaje.

BFFM_SETSELECTION

Este mensaje selecciona un elemento en el cuadro de diálogo.

El lParam de este mensaje es un puntero a una cadena TCHAR que contiene ADsPath del elemento que se va a seleccionar. Aunque hay versiones ANSI y Unicode de este mensaje, ambas versiones toman un puntero a una cadena Unicode.

No se usa el valor devuelto de este mensaje.

[in] uMsg

Especifica uno de los siguientes mensajes de exploración.

BFFM_INITIALIZED

Esta notificación se envía después de inicializar el cuadro de diálogo.

lParam no se usa.

El valor devuelto de esta notificación se omite.

BFFM_SELCHANGED

Esta notificación se envía después de cambiar la selección en el cuadro de diálogo.

lParam es un puntero a una cadena Unicode que contiene ADsPath del elemento recién seleccionado.

El valor devuelto de esta notificación se omite.

DSBM_CHANGEIMAGESTATE

Reservado.

DSBM_CONTEXTMENU

Esta notificación se envía cuando el cuadro de diálogo recibe un mensaje de WM_CONTEXTMENU .

lParam es el valor wParam pasado con el mensaje WM_CONTEXTMENU .

El valor devuelto de esta notificación se omite.

DSBM_HELP

Esta notificación se envía cuando el cuadro de diálogo recibe un mensaje WM_HELP .

lParam es el valor lParam pasado con el mensaje WM_HELP .

El valor devuelto de esta notificación se omite.

DSBM_QUERYINSERT

Esta notificación se envía antes de que cada objeto contenedor se inserte en el árbol. La aplicación puede usar esta notificación para modificar el contenido del cuadro de diálogo.

lParam es un puntero a una estructura DSBITEM que contiene datos sobre el elemento insertado. Algunos miembros de esta estructura, como szDisplayName, se pueden modificar durante esta notificación para cambiar la forma en que se muestran los elementos.

Devuelve un valor distinto de cero de esta notificación si cambian los datos de la estructura DSBITEM . Devuelve cero si la hora se debe insertar sin cambios.

Nota Solo se admite la versión Unicode de este mensaje, DSBM_QUERYINSERTW. no se admite DSBM_QUERYINSERTA.

[in] lParam

El valor y significado de este parámetro viene determinado por la notificación recibida. Para obtener más información, consulte las descripciones del mensaje de notificación en el parámetro uMsg .

[in] lpData

Contiene un puntero a la estructura DSBROWSEINFO que se pasa a la función DsBrowseForContainer . Esto es cierto para todos los mensajes de notificación.

Valor devuelto

None

Observaciones

Los valores de mensaje DSBM_* se definen en Dsclient.h.

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	shlobj_core.h