IMsgServiceAdmin::DeleteMsgService
Gilt für: Outlook 2013 | Outlook 2016
Löscht einen Nachrichtendienst aus einem Profil.
HRESULT DeleteMsgService(
LPMAPIUID lpuid
);
Parameter
lpuid
[in] Ein Zeiger auf die MAPIUID-Struktur , die den eindeutigen Bezeichner für den zu löschenden Nachrichtendienst enthält.
Rückgabewert
S_OK
Der Nachrichtendienst wurde gelöscht.
MAPI_E_NOT_FOUND
Die MAPIUID , auf die von lpuid verwiesen wird, stimmt nicht mit einem vorhandenen Nachrichtendienst überein.
Hinweise
Die IMsgServiceAdmin::D eleteMsgService-Methode löscht einen Nachrichtendienst aus einem Profil. DeleteMsgService entfernt alle Profilabschnitte im Zusammenhang mit dem Nachrichtendienst.
DeleteMsgService führt die folgenden Schritte aus, um den Nachrichtendienst zu löschen:
Ruft die Einstiegspunktfunktion des Nachrichtendiensts auf, wobei der ulContext-Parameter auf MSG_SERVICE_DELETE festgelegt ist, bevor die Profilabschnitte entfernt werden. Dadurch kann der Dienst dienstspezifische Aufgaben ausführen.
Löscht den Nachrichtendienst.
Löscht den Profilabschnitt des Nachrichtendiensts.
Die Einstiegspunktfunktion des Nachrichtendiensts wird nach dem Löschen des Diensts nicht mehr aufgerufen.
Hinweise für Aufrufer
Um die MAPIUID-Struktur für den zu löschenden Nachrichtendienst abzurufen, rufen Sie die Eigenschaftsspalte PR_SERVICE_UID (PidTagServiceUid) aus der Zeile des Nachrichtendiensts in der Nachrichtendiensttabelle ab. Weitere Informationen finden Sie in der in der IMsgServiceAdmin::CreateMsgService-Methode beschriebenen Prozedur.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDeleteSelectedItem |
MFCMAPI verwendet die IMsgServiceAdmin::D eleteMsgService-Methode , um den ausgewählten Dienst zu löschen. |