IProfAdmin::DeleteProfile
Gilt für: Outlook 2013 | Outlook 2016
Löscht ein Profil.
HRESULT DeleteProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
Parameter
lpszProfileName
[in] Ein Zeiger auf den Namen des zu löschenden Profils.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie ein Profil gelöscht wird. Das folgende Flag kann festgelegt werden:
MAPI_APP_PROFILE
Ermöglicht das Löschen eines "App"-Profils. Dieses Flag muss festgelegt werden, wenn das zu löschende Profil ein "App"-Profil ist.
Dieses Flag wird möglicherweise nicht in allen MAPI-Implementierungen erkannt oder unterstützt.
Rückgabewert
S_OK
Das Profil wurde erfolgreich gelöscht.
MAPI_E_NO_ACCESS
Das Profil ist ein "App"-Profil, und das MAPI_APP_PROFILE-Flag wurde nicht festgelegt.
MAPI_E_NOT_FOUND
Das angegebene Profil ist nicht vorhanden.
Hinweise
Die IProfAdmin::D eleteProfile-Methode löscht ein Profil. Wenn das zu löschende Profil verwendet wird, wenn DeleteProfile aufgerufen wird, gibt DeleteProfile S_OK zurück, löscht das Profil jedoch nicht sofort. Stattdessen markiert DeleteProfile das Profil zum Löschen und löscht es, nachdem es nicht mehr verwendet wird, wenn alle aktiven Sitzungen beendet wurden.
Die Einstiegspunktfunktion für jeden Nachrichtendienst im Profil wird mit dem im ulContext-Parameter festgelegten MSG_SERVICE_DELETE-Wert aufgerufen. Zuerst löscht die Funktion den Dienst und dann den Profilabschnitt des Diensts. Die Einstiegspunktfunktion des Nachrichtendiensts wird nicht erneut aufgerufen, nachdem der Dienst gelöscht wurde.
Zum Löschen eines Profils ist kein Kennwort erforderlich.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrRemoveProfile |
MFCMAPI verwendet die IProfAdmin::D eleteProfile-Methode , um das ausgewählte Profil zu löschen. |