Función de devolución de llamada BFFCALLBACK (shlobj_core.h)
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.
[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 |