IMsgServiceAdmin::CopyMsgService
Gilt für: Outlook 2013 | Outlook 2016
Kopiert einen Nachrichtendienst in ein Profil.
HRESULT CopyMsgService(
LPMAPIUID lpUID,
LPSTR lpszDisplayName,
LPCIID lpInterfaceToCopy,
LPCIID lpInterfaceDst,
LPVOID lpObjectDst,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameter
lpUID
[in] Ein Zeiger auf die MAPIUID-Struktur , die den eindeutigen Bezeichner des zu kopierenden Nachrichtendiensts enthält.
lpszDisplayName
[in] Dieser Parameter ist veraltet.
lpInterfaceToCopy
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), der die Schnittstelle darstellt, die für den Zugriff auf den Profilabschnitt des zu kopierenden Nachrichtendiensts verwendet werden soll. Die Übergabe von NULL führt dazu, dass die Standardprofilabschnittsschnittstelle IProfSect verwendet wird.
lpInterfaceDst
[in] Ein Zeiger auf die IID, der die Schnittstelle darstellt, die für den Zugriff auf das Objekt verwendet werden soll, auf das der lpObjectDst-Parameter verweist. Die Übergabe von NULL führt dazu, dass die Sitzungsschnittstelle IMAPISession verwendet wird. Der lpInterfaceDst-Parameter kann auch auf IID_IMsgServiceAdmin festgelegt werden.
lpObjectDst
[in] Ein Zeiger auf einen Zeiger auf ein Sitzungs- oder Nachrichtendienstverwaltungsobjekt. Der Typ des Objekts sollte dem schnittstellenbezeichner entsprechen, der in lpInterfaceDst übergeben wird. Gültige Objektzeiger sind LPMAPISESSION und LPSERVICEADMIN.
ulUIParam
[in] Ein Handle für das übergeordnete Fenster aller Dialogfelder oder Fenster, die von dieser Methode angezeigt werden.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie der Nachrichtendienst kopiert wird. Die folgenden Flags können festgelegt werden:
SERVICE_UI_ALWAYS
Fordert an, dass der Nachrichtendienst immer ein Konfigurationseigenschaftenblatt anzeigt.
Rückgabewert
S_OK
Der Nachrichtendienst wurde erfolgreich kopiert.
MAPI_E_NO_ACCESS
Der Nachrichtendienst befindet sich bereits im Profil und lässt nicht mehrere Instanzen von sich selbst zu.
MAPI_E_NOT_FOUND
Die MAPIUID , auf die von lpUID verwiesen wird, verweist nicht auf einen vorhandenen Nachrichtendienst.
Hinweise
Die IMsgServiceAdmin::CopyMsgService-Methode kopiert einen Nachrichtendienst in ein Profil, entweder das aktive Profil oder ein anderes Profil. Das Profil, das den zu kopierenden Nachrichtendienst und das Ziel enthält, muss nicht dasselbe Profil sein, kann aber sein.
Die Einstiegspunktfunktion des Nachrichtendiensts wird für einen Kopiervorgang nicht aufgerufen. Der kopierte Nachrichtendienst verfügt über die gleichen Konfigurationseinstellungen wie sein Original. Um diese Einstellungen zu ändern, sollte ein Client die IMsgServiceAdmin::ConfigureMsgService-Methode aufrufen.