WIZARDENTRY
Hace referencia a: Outlook 2013 | Outlook 2016
Define una función de punto de entrada del proveedor de servicios a la que llama el Asistente para perfiles para recuperar suficiente información para mostrar las hojas de propiedades de configuración 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 |
ULONG WIZARDENTRY(
HINSTANCE hProviderDLLInstance,
LPSTR FAR * lpcsResourceName,
DLGPROC FAR * lppDlgProc,
LPMAPIPROP lpMAPIProp,
LPMAPISUPPORTOBJECT lpMapiSupportObject
);
Parameters
hProviderDLLInstance
[in] Identificador de instancia del archivo DLL del proveedor de servicios.
lpcsResourceName
[out] Puntero a una cadena que contiene el nombre completo del recurso de diálogo que debe mostrar el Asistente para perfiles durante la configuración. El tamaño máximo de la cadena, incluido el terminador NULL, es de 32 caracteres.
lppDlgProc
[out] Puntero a un procedimiento de cuadro de diálogo estándar de Windows al que llamará el Asistente para perfiles para notificar al proveedor de varios eventos.
lpMAPIProp
[in] Puntero a una implementación de interfaz de propiedad que proporciona acceso a las propiedades de configuración.
lpMapiSupportObject
[in] Puntero al objeto de compatibilidad mapi aplicable a esta sesión.
Valor devuelto
S_OK
Se llamó correctamente a la función WIZARDENTRY del proveedor de servicios.
MAPI_E_CALL_FAILED
Un error de origen inesperado o desconocido impidió que se completara la operación.
Comentarios
El Asistente para perfiles llama a la función basada en WIZARDENTRY cuando está lista para mostrar la interfaz de usuario de configuración del proveedor de servicios. Cuando el Asistente para perfiles termina de configurar todos los proveedores, escribe las propiedades de configuración en el perfil llamando a IMsgServiceAdmin::ConfigureMsgService.
Notas a los implementadores
El nombre de la función basada en WIZARDENTRY debe colocarse en la entrada WIZARD_ENTRY_NAME de MAPISVC.INF.
El nombre del recurso es el del recurso de cuadro de diálogo que se representará en el panel del Asistente para perfiles. El recurso que se pasa de vuelta debe contener todas las páginas de un único recurso de diálogo. Cuando el Asistente para perfiles recibe este recurso, omite el estilo del cuadro de diálogo, pero no los estilos de control, y crea todos los controles como elementos secundarios de la página Asistente para perfiles. Todos los controles están ocultos inicialmente. Los proveedores deben asegurarse de que las coordenadas de sus controles sean de base cero o cero y que no superen un ancho máximo de 200 unidades de diálogo y un alto máximo de 150 unidades de diálogo. Los identificadores de control inferiores a 400 se reservan para el Asistente para perfiles. El Asistente para perfiles muestra el título del proveedor en negrita sobre la interfaz de usuario del proveedor.
El proveedor debe conservar el puntero de interfaz de propiedad proporcionado en el parámetro lpMAPIProp para futuras referencias. El Asistente para perfiles solo se ocupa del conjunto más básico de propiedades y el proveedor puede usar la implementación de la interfaz de propiedad para incluir propiedades adicionales. Durante la configuración, los proveedores deben agregar sus propiedades de configuración al objeto que implementa la interfaz de propiedad. Una vez configurados todos los proveedores, el Asistente para perfiles agrega estas propiedades al perfil.
Para obtener más información sobre cómo usar esta función, consulte Compatibilidad con la configuración del servicio de mensajes.