IProviderAdmin::DeleteProvider
Gilt für: Outlook 2013 | Outlook 2016
Löscht einen Dienstanbieter aus dem Nachrichtendienst.
HRESULT DeleteProvider(
LPMAPIUID lpUID
);
Parameter
lpUID
[in, out] Ein Zeiger auf die MAPIUID-Struktur , die den eindeutigen Bezeichner enthält, der den zu löschenden Anbieter darstellt.
Rückgabewert
S_OK
Der Anbieter wurde erfolgreich aus dem Nachrichtendienst gelöscht.
MAPI_E_NOT_FOUND
Die MAPIUID , auf die der lpUID-Parameter verweist, wurde nicht erkannt.
Hinweise
Die IProviderAdmin::D eleteProvider-Methode löscht einen Dienstanbieter aus dem Nachrichtendienst. DeleteProvider bestimmt den zu löschenden Dienstanbieter, indem die MAPIUID-Struktur , auf die lpUID verweist, mit dem Satz von Bezeichnern übereinstimmt, die von den aktiven Dienstanbietern registriert wurden.
Die meisten Nachrichtendienste lassen nicht zu, dass Anbieter gelöscht werden, während das Profil verwendet wird. Wenn der zu löschende Anbieter verwendet wird, markiert DeleteProvider ihn zum Löschen, anstatt ihn sofort zu entfernen, und gibt S_OK zurück. Wenn der Anbieter nicht mehr verwendet wird, wird er gelöscht.
DeleteProvider ruft die Einstiegspunktfunktion des Nachrichtendiensts auf, bevor der Anbieter aus dem Dienst entfernt wird. Der ulContext-Parameter ist auf MSG_SERVICE_PROVIDER_DELETE festgelegt. Die Einstiegspunktfunktion des Nachrichtendiensts führt die folgenden Aufgaben aus:
Löscht den Dienstanbieter.
Löscht den Profilabschnitt des Dienstanbieters.
Die Einstiegspunktfunktion des Nachrichtendiensts wird nach dem Löschen des Anbieters nicht mehr aufgerufen.