LAUNCHWIZARDENTRY

Hace referencia a: Outlook 2013 | Outlook 2016

Define una función que inicia la aplicación Asistente para perfiles con el fin de agregar uno o varios servicios de mensajes a un perfil.

Propiedad	Valor
Archivo de encabezado:	Mapiwz.h
Función definida implementada por:	MAPI
Función definida a la que llama:	Aplicaciones cliente

HRESULT LAUNCHWIZARDENTRY(
  HWND hParentWnd,
  ULONG ulFlags,
  LPCSTR FAR * lppszServiceNameToAdd,
  ULONG cbBufferMax,
  LPSTR lpszNewProfileName
);

Parameters

hParentWnd

[in] Identificador de la ventana primaria del autor de la llamada. Si el llamador no tiene una ventana primaria, el parámetro hParentWnd debe ser NULL.

ulFlags

[in] Máscara de bits de marcas que indican las opciones del Asistente para perfiles. Se pueden establecer las siguientes marcas:

MAPI_PW_ADD_SERVICE_ONLY

El Asistente para perfiles es agregar solo los servicios de mensajes enumerados a través del parámetro lppszServiceNameToAdd y no mostrar su página para seleccionar servicios de mensajes.

MAPI_PW_FIRST_PROFILE

El perfil que se va a crear es el primero para esta estación de trabajo.

MAPI_PW_HIDE_SERVICES_LIST

No se debe mostrar la página del Asistente para perfiles para seleccionar servicios de mensajes.

MAPI_PW_LAUNCHED_BY_CONFIG

La aplicación de configuración de Panel de control inició el Asistente para perfiles.

MAPI_PW_PROVIDER_UI_ONLY

Solo se deben mostrar los cuadros de diálogo de configuración de los proveedores de servicios y no deben aparecer las páginas del Asistente para perfiles. Esta marca solo se puede establecer si se establece la marca de MAPI_PW_ADD_SERVICE_ONLY.

lppszServiceNameToAdd

[in] Puntero a una matriz de cadenas que contiene los nombres de los servicios de mensajes que se van a agregar al perfil. La matriz debe finalizar con un valor NULL.

cbBufferMax

[in] Tamaño del búfer al que apunta el parámetro lpszNewProfileName .

lpszNewProfileName

[out] Puntero a un búfer de cadena donde la función basada en LAUNCHWIZARDENTRY devuelve el nombre del perfil creado.

Valor devuelto

S_OK

La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.

MAPI_E_CALL_FAILED

Un error de origen inesperado o desconocido impidió que se completara la operación. Entre las posibilidades se incluyen el error al inicializar el subsistema MAPI para el Asistente para perfiles, la imposibilidad de acceder al perfil predeterminado y la devolución de un error desde el cuadro de diálogo.

Comentarios

La implementación MAPI del prototipo de función LAUNCHWIZARDENTRY es el punto de entrada en la aplicación Asistente para perfiles MAPI. MAPI denomina a este punto de entrada LaunchWizard.

Cuando se establece la marca de MAPI_PW_ADD_SERVICE_ONLY en el parámetro ulFlags , se aplican las reglas siguientes:

• La marca MAPI_PW_LAUNCHED_BY_CONFIG impide que se muestre la página de bienvenida.

• Las marcas MAPI_PW_HIDE_SERVICES_LIST y MAPI_PW_PROVIDER_UI_ONLY solo son útiles cuando no hay ningún perfil predeterminado. En este caso, estas marcas determinan qué página del Asistente para perfiles se va a mostrar.

• Si existe un perfil predeterminado, no se mostrará ninguna de las páginas del Asistente para perfiles.

• Si existe un perfil predeterminado, solo se muestra un servicio de mensajes a través del parámetro lppszServiceNameToAdd y ese servicio de mensajes ya está en el perfil predeterminado, el Asistente para perfiles devuelve S_OK sin agregar nada al perfil.

Para que cada servicio de mensajes se agregue al perfil, el Asistente para perfiles llama a la función de punto de entrada del servicio en función del prototipo MSGSERVICEENTRY . Para cada proveedor de servicios seleccionado de un servicio de mensajes que se va a agregar al perfil, el Asistente para perfiles llama a la función de punto de entrada del proveedor en función del prototipo WIZARDENTRY . Durante la configuración interactiva, cada evento de usuario en las páginas de propiedades hace que el Asistente para perfiles llame a la función de devolución de llamada del proveedor en función del prototipo SERVICEWIZARDDLGPROC .

Si un proveedor de servicios que se agrega al perfil admite las páginas del Asistente para perfiles, debe permitir la configuración mediante programación del perfil.