IMsgServiceAdmin::CopyMsgService
S’applique à : Outlook 2013 | Outlook 2016
Copie un service de message dans un profil.
HRESULT CopyMsgService(
LPMAPIUID lpUID,
LPSTR lpszDisplayName,
LPCIID lpInterfaceToCopy,
LPCIID lpInterfaceDst,
LPVOID lpObjectDst,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Paramètres
lpUID
[in] Pointeur vers la structure MAPIUID qui contient l’identificateur unique du service de message à copier.
lpszDisplayName
[in] Ce paramètre a été déprécié.
lpInterfaceToCopy
[in] Pointeur vers l’identificateur d’interface (IID) qui représente l’interface à utiliser pour accéder à la section profil du service de message à copier. La transmission de la valeur NULL entraîne l’utilisation de l’interface de section de profil standard, IProfSect.
lpInterfaceDst
[in] Pointeur vers l’IID qui représente l’interface à utiliser pour accéder à l’objet vers lequel pointe le paramètre lpObjectDst . Le passage de null entraîne l’utilisation de l’interface de session IMAPISession. Le paramètre lpInterfaceDst peut également être défini sur IID_IMsgServiceAdmin.
lpObjectDst
[in] Pointeur vers un pointeur vers un objet d’administration de session ou de service de messages. Le type d’objet doit correspondre à l’identificateur d’interface passé dans lpInterfaceDst. Les pointeurs d’objet valides sont LPMAPISESSION et LPSERVICEADMIN.
ulUIParam
[in] Handle de la fenêtre parente de toutes les boîtes de dialogue ou fenêtres affichées par cette méthode.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont le service de message est copié. Les indicateurs suivants peuvent être définis :
SERVICE_UI_ALWAYS
Demande que le service de message affiche toujours une feuille de propriétés de configuration.
Valeur renvoyée
S_OK
Le service de message a été correctement copié.
MAPI_E_NO_ACCESS
Le service de message est déjà dans le profil et n’autorise pas plusieurs instances de lui-même.
MAPI_E_NOT_FOUND
Le MAPIUID pointé par lpUID ne fait pas référence à un service de message existant.
Remarques
La méthode IMsgServiceAdmin ::CopyMsgService copie un service de message dans un profil, le profil actif ou un autre profil. Le profil qui contient le service de message à copier et la destination n’ont pas besoin d’être le même profil, mais ils peuvent l’être.
La fonction de point d’entrée du service de message n’est pas appelée pour une opération de copie. Le service de message copié a les mêmes paramètres de configuration que son service d’origine. Pour modifier ces paramètres, un client doit appeler la méthode IMsgServiceAdmin ::ConfigureMsgService .