IProfAdmin::SetDefaultProfile
Gilt für: Outlook 2013 | Outlook 2016
Legt das Standardprofil eines Clients fest oder löscht es.
HRESULT SetDefaultProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
Parameter
lpszProfileName
[in] Ein Zeiger auf den Namen des Profils, das zum Standard wird, oder NULL. Das Festlegen von lpszProfileName auf NULL gibt an, dass SetDefaultProfile das vorhandene Standardprofil entfernen soll, sodass der Client keine Standardeinstellung aufweist.
ulFlags
[in] Eine Bitmaske von Flags, die den Typ der Zeichenfolge steuert, auf die von lpszProfileName verwiesen wird. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Der Profilname weist das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, weist der Profilname das ANSI-Format auf.
Rückgabewert
S_OK
Ein Standardprofil wurde erfolgreich eingerichtet oder entfernt.
E_FAIL
Das angegebene Profil kann nicht als Standardprofil festgelegt werden.
MAPI_E_NOT_FOUND
Das angegebene Profil ist nicht vorhanden.
Hinweise
Die IProfAdmin::SetDefaultProfile-Methode richtet entweder ein bestimmtes Profil als Standardprofil des Clients ein oder löscht das aktuelle Standardprofil. Ein "App"-Profil kann nicht als Standardprofil festgelegt werden. Das Standardprofil ist das Profil, das automatisch verwendet wird, wenn der Client eine MAPI-Sitzung beginnt. SetDefaultProfile legt auch die eigenschaft PR_DEFAULT_PROFILE (PidTagDefaultProfile) des neuen Standardprofils auf TRUE fest.
Hinweise für Aufrufer
Um eine Sitzung mit dem Standardprofil zu starten, übergeben Sie das MAPI_USE_DEFAULT-Flag an die MAPILogonEx-Funktion .