SERVICEWIZARDDLGPROC

Hace referencia a: Outlook 2013 | Outlook 2016

Define una función de devolución de llamada invocada por el Asistente para perfiles para permitir que un proveedor de servicios reaccione a los eventos de usuario cuando se muestran las hojas de propiedades o las páginas del proveedor.

Propiedad	Valor
Archivo de encabezado:	Mapiwz.h
Función definida implementada por:	Proveedores de servicios
Función definida a la que llama:	Asistente para perfiles MAPI

BOOL SERVICEWIZARDDLGPROC(
  HWND hDlg,
  UINT wMsgID,
  WPARAM wParam,
  LPARAM lParam
);

Parameters

hDlg

[in] Identificador de ventana al cuadro de diálogo Asistente para perfiles.

wMsgID

[in] Mensaje de ventana que se va a procesar. Además de los mensajes de ventana normales esperados por un cuadro de diálogo modal, se pueden recibir los siguientes mensajes:

WM_CLOSE

Se ha completado el Asistente para perfiles. El proveedor de servicios debe realizar toda la limpieza necesaria, como desasignar cualquier memoria asignada dinámicamente.

WM_COMMAND

Se ha seleccionado uno de los controles del proveedor o se ha hecho clic en el botón Siguiente o Atrás . El valor del parámetro wParam indica cuál de estos eventos de usuario se ha producido.

WM_INITDIALOG

El usuario se ha movido a otra página de propiedades, para la que se debe inicializar el cuadro de diálogo. El proveedor debe inicializar los controles que el Asistente para perfiles ha agregado al cuadro de diálogo.

WIZ_QUERYNUMPAGES

El Asistente para perfiles solicita el número de páginas que el proveedor debe mostrar. El proveedor debe devolver el número de páginas en lugar de TRUE o FALSE. Por ejemplo, use la siguiente instrucción return para indicar que se deben mostrar tres páginas:

return (BOOL)3;

wParam

[in] Parámetro de 32 bits asociado a mensajes de ventana. Los valores posibles dependen del mensaje especificado en el parámetro wMsgID . Además de los valores esperados con los mensajes de ventana normales de un cuadro de diálogo modal, se pueden recibir los siguientes valores:

WIZ_NEXT

Cuando wMsgID contiene WM_COMMAND, el usuario ha hecho clic en el botón Siguiente .

WIZ_PREV

Cuando wMsgID contiene WM_COMMAND, el usuario ha hecho clic en el botón Atrás .

lParam

[in] Parámetro de 32 bits asociado a mensajes de ventana. Los valores posibles dependen del mensaje especificado en el parámetro wMsgID .

Valor devuelto

El valor devuelto por una función basada en SERVICEWIZARDDLGPROC depende del mensaje de ventana recibido. Tenga en cuenta, en particular, el valor devuelto excepcional para el mensaje de WIZ_QUERYNUMPAGES. Los valores devueltos normales son:

TRUE

El proveedor de servicios ha procesado el mensaje de ventana recibido.

FALSE

El proveedor de servicios no ha procesado el mensaje de ventana recibido.

Comentarios

Cuando el usuario se mueve de una página de propiedades a otra, el proveedor es responsable de ocultar los controles de la página anterior y mostrar los controles de la página siguiente o anterior. Cuando el usuario hace clic en el botón Siguiente , se llama a la función basada en SERVICEWIZARDDLGPROC con el mensaje WM_COMMAND y WIZ_NEXT en el parámetro wParam . En los pasos siguientes se describe lo que ocurre entre el momento en que el usuario hace clic en Siguiente y la hora en que se representan las páginas de configuración del primer proveedor.

1. El Asistente para perfiles oculta los controles que se encuentran en la ventana.

2. El Asistente para perfiles agrega los controles ocultos del proveedor a la página.

3. El Asistente para perfiles llama a SERVICEWIZARDDLGPROC, enviando el mensaje WM_INITDIALOG, para que el proveedor pueda inicializar los controles.

4. El Asistente para perfiles llama a SERVICEWIZARDDLGPROC y envía el mensaje WIZ_QUERYNUMPAGES. El proveedor devuelve el número de páginas que se van a mostrar.

5. El Asistente para perfiles llama a SERVICEWIZARDDLGPROC y envía el mensaje de WM_COMMAND con el parámetro wParam establecido en WIZ_NEXT o WIZ_PREV. En este momento, el proveedor devuelve FALSE {error} o revela sus controles y devuelve TRUE {success}. Si el Asistente para perfiles pasa ID_NEXT, se muestra la primera página del proveedor. Si se pasa ID_PREV, se muestra la última página.

6. El Asistente para perfiles llama a la función SERVICEWIZARDDLGPROC del proveedor, enviando el mensaje de WM_COMMAND con el parámetro wParam establecido en WIZ_NEXT o WIZ_PREV (dependiendo del botón en el que el usuario haya hecho clic). El proveedor es responsable de mostrar u ocultar sus controles y escribir sus datos en el IMAPIProp pasado al Asistente para perfiles para recorrer su secuencia de páginas. El proveedor debe devolver TRUE si la página siguiente o anterior se mostró correctamente y FALSE si no se pudo mostrar la página siguiente ni la anterior. El proveedor debe tener en cuenta cuándo está saliendo de su secuencia de páginas y responder adecuadamente ocultando sus controles y escribiendo sus datos en el perfil.

7. Si el usuario realiza pasos fuera del intervalo de páginas del proveedor, el Asistente para perfiles elimina los controles ocultos del proveedor del cuadro de diálogo y llama al proveedor siguiente o muestra su página siguiente si ese fue el último proveedor.