IMsgServiceAdmin::CopyMsgService
Hace referencia a: Outlook 2013 | Outlook 2016
Copia un servicio de mensajes en un perfil.
HRESULT CopyMsgService(
LPMAPIUID lpUID,
LPSTR lpszDisplayName,
LPCIID lpInterfaceToCopy,
LPCIID lpInterfaceDst,
LPVOID lpObjectDst,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameters
lpUID
[in] Puntero a la estructura MAPIUID que contiene el identificador único del servicio de mensajes que se va a copiar.
lpszDisplayName
[in] Este parámetro ha quedado en desuso.
lpInterfaceToCopy
[in] Puntero al identificador de interfaz (IID) que representa la interfaz que se va a usar para acceder a la sección de perfil del servicio de mensajes que se va a copiar. Al pasar NULL, se usa la interfaz de sección de perfil estándar , IProfSect.
lpInterfaceDst
[in] Puntero al IID que representa la interfaz que se va a usar para tener acceso al objeto al que apunta el parámetro lpObjectDst . Si se pasa NULL, se usa la interfaz de sesión IMAPISession. El parámetro lpInterfaceDst también se puede establecer en IID_IMsgServiceAdmin.
lpObjectDst
[in] Puntero a un puntero a un objeto de administración del servicio de mensajes o sesión. El tipo de objeto debe corresponder al identificador de interfaz pasado en lpInterfaceDst. Los punteros de objeto válidos son LPMAPISESSION y LPSERVICEADMIN.
ulUIParam
[in] Identificador de la ventana primaria de los cuadros de diálogo o ventanas que muestra este método.
ulFlags
[in] Máscara de bits de marcas que controla cómo se copia el servicio de mensajes. Se pueden establecer las siguientes marcas:
SERVICE_UI_ALWAYS
Solicita que el servicio de mensajes siempre muestre una hoja de propiedades de configuración.
Valor devuelto
S_OK
El servicio de mensajes se copió correctamente.
MAPI_E_NO_ACCESS
El servicio de mensajes ya está en el perfil y no permite varias instancias de sí mismo.
MAPI_E_NOT_FOUND
La MAPIUID a la que apunta lpUID no hace referencia a un servicio de mensajes existente.
Comentarios
El método IMsgServiceAdmin::CopyMsgService copia un servicio de mensajes en un perfil, ya sea el perfil activo u otro perfil. El perfil que contiene el servicio de mensajes que se va a copiar y el destino no tiene que ser el mismo perfil, pero puede serlo.
No se llama a la función de punto de entrada del servicio de mensajes para una operación de copia. El servicio de mensajes copiados tiene los mismos valores de configuración que su original. Para cambiar esta configuración, un cliente debe llamar al método IMsgServiceAdmin::ConfigureMsgService .