IProfAdmin::RenameProfile
Gilt für: Outlook 2013 | Outlook 2016
Weist einem Profil einen neuen Namen zu.
HRESULT RenameProfile(
LPSTR lpszOldProfileName,
LPSTR lpszOldPassword,
LPSTR lpszNewProfileName,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameter
lpszOldProfileName
[in] Ein Zeiger auf den aktuellen Namen des umzubenennten Profils.
lpszOldPassword
[in] Immer NULL.
lpszNewProfileName
[in] Ein Zeiger auf den neuen Namen des umzubenennten Profils.
ulUIParam
[in] Ein Handle für das übergeordnete Fenster aller Dialogfelder oder Fenster, die von dieser Methode angezeigt werden.
ulFlags
[in] Immer NULL.
Rückgabewert
S_OK
Das Profil wurde erfolgreich umbenannt.
MAPI_E_LOGON_FAILED
Das Profilkennwort ist falsch.
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::RenameProfile-Methode weist einem Profil einen neuen Namen zu, falls vorhanden. Wenn das umzubenennende Profil von einem Client verwendet wird, wenn RenameProfile aufgerufen wird, markiert RenameProfile das Profil und gibt S_OK zurück, anstatt den Umbenennungsvorgang zu versuchen, während das Profil verwendet wird. Wenn das Profil nicht mehr verwendet wird, weist RenameProfile ihm den neuen Namen zu.
Die alten und neuen Namen des Profils 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.
Das lpszPassword sollte immer NULL oder ein Zeiger auf eine leere Zeichenfolge sein.