IMAPISupport::SetProviderUID
Gilt für: Outlook 2013 | Outlook 2016
Registriert eine MAPIUID-Struktur , die den Dienstanbieter eindeutig darstellt.
HRESULT SetProviderUID(
LPMAPIUID lpProviderID,
ULONG ulFlags
);
Parameter
lpProviderID
[in] Ein Zeiger auf die MAPIUID-Struktur , die das Adressbuch oder den Nachrichtenspeicheranbieter identifiziert.
ulFlags
Reserviert; muss null sein.
Rückgabewert
S_OK
Die MAPIUID-Struktur wurde erfolgreich registriert.
Hinweise
Die IMAPISupport::SetProviderUID-Methode wird für Adressbuch- und Nachrichtenspeicheranbieterunterstützungsobjekte implementiert. Diese Anbieter rufen SetProviderUID auf, um einen eindeutigen Bezeichner zu registrieren, der in der MAPIUID-Struktur beschrieben ist, auf die von lpProviderID verwiesen wird. Anbieter schließen diesen Bezeichner in alle eintragsbezeichner ein, die sie erstellen.
MAPI verwendet die MAPIUID-Struktur , wenn ausgehende Nachrichten an den MAPI-Spooler gesendet und der geeignete Anbieter für die Verarbeitung von Clientanforderungen bestimmt wird. Wenn beispielsweise ein Client die IMAPISession::OpenEntry-Methode aufruft, untersucht MAPI den MAPIUID-Teil des Eintragsbezeichners, ordnet ihn dem Anbieter zu, der ihn an SetProviderUID übergeben hat, und ruft openEntry dieses Anbieters auf.
Hinweise für Aufrufer
Rufen Sie SetProviderUID zum Anmeldezeitpunkt auf, um Ihre MAPIUID-Struktur zu registrieren. MAPI ermöglicht Es Adressbuch- und Nachrichtenspeicheranbietern, mehrere Bezeichner zu registrieren. Wenn Sie mehrere Aufrufe an SetProviderUID vornehmen, wird immer die MAPIUID-Struktur dem MapIUID-Satz des Anbieters hinzugefügt, auch wenn die MAPIUID ein Duplikat ist. SetProviderUID kann keine MAPIUID entfernen.