IProfAdmin::CopyProfile
Gilt für: Outlook 2013 | Outlook 2016
Kopiert ein Profil.
HRESULTCopyProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameter
lpszOldProfileName
[in] Ein Zeiger auf den Namen des zu kopierenden Profils.
lpszOldPassword
[in] Ein Zeiger auf das Kennwort des zu kopierenden Profils.
lpszNewProfileName
[in] Ein Zeiger auf den neuen Namen des kopierten Profils.
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 das Profil kopiert wird. Die folgenden Flags können festgelegt werden:
MAPI_APP_PROFILE
Ermöglicht das Kopieren eines "App"-Profils. Dieses Flag muss festgelegt werden, wenn das vorhandene Profil ein "App"-Profil ist.
Dieses Flag wird möglicherweise nicht in allen MAPI-Implementierungen erkannt oder unterstützt.
MAPI_DIALOG
Zeigt ein Dialogfeld an, in dem der Benutzer zur Eingabe des richtigen Kennworts des zu kopierenden Profils aufgefordert wird. Wenn dieses Flag nicht festgelegt ist, wird kein Dialogfeld angezeigt.
Rückgabewert
S_OK
Das Profil wurde erfolgreich kopiert.
MAPI_E_ACCESS_DENIED
Der neue Profilname ist identisch mit dem Namen eines vorhandenen Profils.
MAPI_E_LOGON_FAILED
Das Kennwort für das zu kopierende Profil ist falsch, und dem Benutzer konnte kein Dialogfeld angezeigt werden, um das richtige Kennwort anzufordern, da MAPI_DIALOG im ulFlags-Parameter nicht festgelegt wurde.
MAPI_E_NO_ACCESS
Das vorhandene Profil ist ein "App"-Profil, und das MAPI_APP_PROFILE-Flag wurde nicht festgelegt.
MAPI_E_NOT_FOUND
Das angegebene Profil ist nicht vorhanden.
MAPI_E_USER_CANCEL
Der Benutzer hat den Vorgang in der Regel abgebrochen, indem er in einem Dialogfeld auf die Schaltfläche Abbrechen geklickt hat.
Hinweise
Die IProfAdmin::CopyProfile-Methode erstellt eine Kopie des Profils, auf das lpszOldProfileName verweist, und gibt ihm den Namen, auf den lpszNewProfileName verweist. Beim Kopieren eines Profils bleibt die Kopie mit demselben Kennwort wie das Original erhalten.
Der Name des ursprünglichen Profils, dessen Kennwort und die Kopie können bis zu 64 Zeichen lang sein und die folgenden Zeichen enthalten:
- Alle alphanumerischen Zeichen, einschließlich Akzentzeichen und Unterstrich.
- Eingebettete Leerzeichen, aber keine führenden oder nachfolgenden Leerzeichen.
Profilkennwörter werden nicht auf allen Betriebssystemen unterstützt. Auf Betriebssystemen, die keine Profilkennwörter unterstützen, kann lpszOldPassword NULL oder ein Zeiger auf eine leere Zeichenfolge sein.
Wenn lpszOldPassword auf NULL festgelegt ist, erfordert das zu kopierende Profil ein Kennwort, und das MAPI_DIALOG-Flag ist festgelegt. Ein Dialogfeld, in dem der Benutzer aufgefordert wird, das Kennwort anzugeben, wird angezeigt. Wenn ein Kennwort erforderlich ist, aber lpszOldPassword auf NULL festgelegt ist und das flag MAPI_DIALOG nicht festgelegt ist, gibt CopyProfile MAPI_E_LOGON_FAILED zurück.
Wenn das vorhandene Profil ein "App"-Profil ist und das flag MAPI_APP_PROFILE nicht festgelegt ist, gibt CopyProfile MAPI_E_NO_ACCESS zurück. Wenn das vorhandene Profil ein "App"-Profil ist und die MAPI_APP_PROFILE festgelegt ist, ist das neue Profil auch ein "App"-Profil. Wenn das vorhandene Profil kein "App"-Profil ist, ist das neue Profil kein "App"-Profil, unabhängig vom MAPI_APP_PROFILE-Flag.