IMsgServiceAdmin::ConfigureMsgService
Hace referencia a: Outlook 2013 | Outlook 2016
Vuelve a configurar un servicio de mensajes.
HRESULT ConfigureMsgService(
LPMAPIUID lpUID,
ULONG_PTR ulUIParam,
ULONG ulFlags,
ULONG cValues,
LPSPropValue lpProps
);
Parameters
lpUID
[in] Puntero a la estructura MAPIUID que contiene el identificador único del servicio de mensajes que se va a configurar.
ulUIParam
[in] Identificador de la ventana primaria de la hoja de propiedades de configuración.
ulFlags
[in] Máscara de bits de marcas que controla la visualización de la hoja de propiedades. Se pueden establecer las siguientes marcas:
MAPI_UNICODE
Las cadenas pasadas están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas están en formato ANSI.
MSG_SERVICE_UI_READ_ONLY
El servicio de mensajes debe mostrar su hoja de propiedades de configuración, pero no permitir que el usuario la cambie. La mayoría de los servicios de mensajes omiten esta marca.
SERVICE_UI_ALLOWED
El servicio de mensajes debe mostrar su hoja de propiedades de configuración solo si el servicio no está completamente configurado.
SERVICE_UI_ALWAYS
El servicio de mensajes siempre debe mostrar su hoja de propiedades de configuración. Si no se establece SERVICE_UI_ALWAYS, se puede seguir mostrando una hoja de propiedades de configuración si se establece SERVICE_UI_ALLOWED y la información de configuración válida no está disponible en la matriz de valores de propiedad en el parámetro lpProps . Se debe establecer SERVICE_UI_ALLOWED o SERVICE_UI_ALWAYS para que se muestre una hoja de propiedades.
cValues
[in] Recuento de valores de propiedad en la estructura SPropValue a la que apunta lpProps.
lpProps
[in] Puntero a una matriz de valores de propiedad que describen las propiedades que se van a mostrar en la hoja de propiedades. El parámetro lpProps no debe ser NULL si el servicio de mensajes debe configurarse sin una interfaz de usuario.
Valor devuelto
S_OK
El servicio de mensajes se configuró correctamente.
MAPI_E_EXTENDED_ERROR
Error específico de un servicio de mensajes. Para obtener la estructura MAPIERROR que describe el error, la aplicación cliente debe llamar al método IMsgServiceAdmin::GetLastError .
MAPI_E_NOT_FOUND
La MAPIUID a la que apunta lpUID no coincide con la de un servicio de mensajes existente.
MAPI_E_NOT_INITIALIZED
El servicio de mensajes no tiene una función de punto de entrada.
MAPI_E_USER_CANCEL
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar de la hoja de propiedades.
Comentarios
El método IMsgServiceAdmin::ConfigureMsgService permite configurar un servicio de mensajes, con o sin una hoja de propiedades de configuración.
Para permitir la configuración sin mostrar una hoja de propiedades, los servicios de mensajes suelen preparar un archivo de encabezado que incluye constantes para todas las propiedades necesarias y opcionales y sus valores.
Notas para los llamadores
Para recuperar la estructura MAPIUID para que el servicio de mensajes se configure, recupere la columna PR_SERVICE_UID (PidTagServiceUid) de la fila del servicio de mensajes en la tabla de servicio de mensajes. Para obtener más información, vea el procedimiento descrito en el método IMsgServiceAdmin::CreateMsgService .
Puede configurar un servicio de mensajes sin mostrar una hoja de propiedades a un usuario solo si tiene información anticipada sobre los valores de propiedad que se van a establecer. Si va a configurar un servicio de mensajes sin mostrar una hoja de propiedades, pase valores de propiedad válidos en el parámetro lpProps y no establezca las marcas de MSG_SERVICE_UI_READ_ONLY, SERVICE_UI_ALLOWED o SERVICE_UI_ALWAYS.
Si recibe toda o parte de la información de configuración del usuario mediante una hoja de propiedades, establezca SERVICE_UI_ALLOWED en ulFlags. Si usa información de propiedad existente solo para establecer la configuración predeterminada y el usuario puede cambiar la configuración, establezca SERVICE_UI_ALWAYS en ulFlags.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
MFCMAPI usa el método IMsgServiceAdmin::ConfigureMsgService para configurar un servicio que se ha agregado a un perfil. |