Freigeben über


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.

Siehe auch

MAPIUID

IMAPISupport: IUnknown