Freigeben über

Neu in dieser Edition (engl.)

Gilt für: Outlook 2013 | Outlook 2016

Die Microsoft Outlook MAPI-Referenz wurde aktualisiert, um Dokumentation für verschiedene neue Funktionen einzuschließen.

Neue Inhalte

Für die folgenden Funktionen wurde Inhalt hinzugefügt:

MAPI-Initialisierungsmonitor

  • Es kann vorkommen, dass eine Anwendung, die MAPI nutzt, wissen möchte, wann die Initialisierung abgeschlossen ist. Es gibt beispielsweise mehrere Threads, die MAPI initialisieren könnten, oder als Reaktion auf die Initialisierung von MAPI möchte die Anwendung einige Aufgaben ausführen, möchte aber nicht immer den MAPI-Stapel starten. Der Initialisierungsmonitor stellt diese Funktionalität über eine Funktion (aus OLMAPI32.DLL exportiert) und einige einfache Schnittstellen bereit, die unten beschrieben werden.

HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)

  • Dies ist ein Einstiegspunkt, der aus OLMAPI32.DLL exportiert wird. Dadurch kann der Aufrufer eine Schnittstelle abrufen, um den aktuellen Initialisierungszustand abzufragen, einen Rückruf für den Abschluss der Initialisierung einzurichten oder den aktuellen Thread zu blockieren, bis er abgeschlossen ist. Das von dieser API zurückgegebene Objekt ist wiederverwendbar und threadsicher und kann von jedem Thread aufgerufen werden, nicht nur von Threads, die es abgerufen haben. Im Gegensatz zu anderen Objekten, die von MAPI verfügbar gemacht werden, ist dieses Objekt gültig, solange die DLL geladen wird. Es kann über Initialisierungssitzungen hinweg erneut verwendet und vor oder nach dem Aufruf von MAPIInitialize verwendet werden. Gibt Erfolg oder Fehler über ein COM-Standard-HRESULT zurück und weist einer Instanz von IMAPIInitMonitor einen Out-Parameter zu.

Schnittstelle: IMAPIInitMonitor

IFACEMETHODIMP_(BOOL) IsInitialized()

  • Gibt den aktuellen Status der MAPI-Initialisierung zurück.

IFACEMETHODIMP Wait(DWORD-Timeout)

  • Initiiert einen BLOCKING-Aufruf für diesen Thread, der zurückgegeben wird, wenn entweder die angegebene Anzahl von Millisekunden verstrichen ist oder MAPI initialisiert wurde. INFINITE kann für eine unendliche Wartezeit verwendet werden.

IFACEMETHODIMP BeginWait(DWORD-Timeout, IMAPIWaitResult ppResult)

  • Starten Sie einen Wartevorgang für die MAPI-Initialisierung oder die angegebene Anzahl von Millisekunden. Dadurch wird eine IMAPIWaitResult-Schnittstelle zurückgegeben, für die „End“ aufgerufen werden muss, um den Wartevorgang zu starten. Dadurch kann der Aufrufer steuern, welcher Thread blockiert wird, während wir warten.

Schnittstelle IMAPIWaitResult

IFACEMETHODIMP End()-Überschreibung

  • Wird aufgerufen, um den blockierenden Wartevorgang für den Thread zu initiieren, in dem er aufgerufen wird. Dies muss nicht derselbe Thread sein, der „BeginWait“ aufgerufen hat.

Zuvor überarbeiteter Inhalt

Für die folgenden Funktionen wurde Inhalt in früheren Versionen der Outlook MAPI-Referenz hinzugefügt:

  • Microsoft Outlook 2013 ermöglicht nicht herkömmliche Bereitstellungsszenarien, z. B. Nebeneinander und Klick-und-Los. Diese Szenarien können die Logik erschweren, die zum Laden der richtigen MAPI-Bibliothek verwendet wird. MAPI-Entwicklungsfachkräfte haben jetzt die Möglichkeit, eine explizite Verknüpfung mit MAPI-Funktionen zu erstellen, und können eine explizite Verknüpfung mit dem MAPI-Stub des MAPI-Standardclients (z. B. Msmapi32.dll von Outlook) auswählen, ohne die MAPI-Bibliothek und den Windows MAPI-Stub zu durchlaufen. Weitere Informationen zur expliziten Verknüpfung im Vergleich zur impliziten Verknüpfung finden Sie unter Link zu MAPI-Funktionen.

  • Die MAPI-Stubbibliothek, die auf MAPIStubLibrary auf GitHub veröffentlicht wurde, bietet einen Drop-In-Ersatz für Mapi32.lib, der das Erstellen von 32-Bit- und 64-Bit-MAPI-Anwendungen unterstützt.

  • Unterstützung für 64-Bit-Microsoft Outlook: Referenzthemen für anwendbare API-Elemente wurden aktualisiert, um neuen Headerdateien zu entsprechen, die 64-Bit-Outlook unterstützen. Diese Headerdateien sind unter MAPIStubLibrary verfügbar. Unter Überprüfen der Outlook-Versionwurde ein neues Codebeispiel bereitgestellt, um zu überprüfen, ob die installierte Version von Outlook 64-Bit-Microsoft Outlook 2010 ist und für Outlook 2013 überarbeitet wurde. Wenn Ihre vorhandene 32-Bit-MAPI-Anwendung unter einem 64-Bit-Betriebssystem mit installiertem 64-Bit-Outlook ausgeführt wird, müssen Sie Ihre 32-Bit-Anwendung als 64-Bit-Anwendung neu erstellen. Weitere Informationen zur MAPI-Unterstützung für 64-Bit-Outlook finden Sie unter Erstellen von MAPI-Anwendungen auf 32-Bit- und 64-Bit-Plattformen.

  • Beispiel für Nachrichtenspeicheranbieter: Der Beispielcode für einen umschlossenen PST-Speicheranbieter wurde zuvor aktualisiert, um die 64-Bit-Architektur zu unterstützen. Das Thema Initialisieren eines umschlossenen PST-Speicheranbieters im Beispiel wurde jetzt erweitert, um Informationen zu den „Umschlossenen PST- und Unicode-Pfaden“ bereitzustellen.

  • AutoVervollständigen-Stream: Das Spitznamen für Cache-Thema, früher das Nk2-Dateiformat, wurde aktualisiert, um Änderungen in Outlook 2013 und Outlook 2010 widerzuspiegeln. Informationen wie die AutoVervollständigen-Liste, bei der es sich um die Liste der Namen handelt, die in den BearbeitungsfeldernAn, Cc und Bcc angezeigt werden, während eine benutzende Person eine E-Mail erstellt, werden jetzt im AutoVervollständigen-Stream einer Nachricht auf dem lokalen Computer gespeichert, anstatt sie in einer Datei wie in Outlook 2007 zu speichern.

    • Interagieren mit dem AutoVervollständigen-Stream

    • Laden des AutoVervollständigen-Streams

    • Speichern des AutoVervollständigen-Streams

  • Unterstützung für schnelles Herunterfahren für MAPI-Clients: MAPI-Clients können jetzt ein schnelles Herunterfahren initiieren und das MAPI-Subsystem geladene Anbieter benachrichtigen lassen, um Datenverluste durch das schnelle Herunterfahren zu minimieren. Für den Client und Anbieter wurden zusätzliche Schnittstellen hinzugefügt, um das schnelle Herunterfahren zu unterstützen. Weitere Informationen zum schnellen Herunterfahren finden Sie unter Herunterfahren des Clients in MAPI.

  • Streamstruktur für Felddefinitionen für ein Outlook-Element: Die Dokumentation für einen binären Datenstrom für die PidLidPropertyDefinitionStream-Eigenschaft wurde hinzugefügt. Diese Eigenschaft gibt Definitionen aller benutzerdefinierten Felder und Datenbindungseinstellungen für integrierte Felder eines Outlook-Elements an.

  • Außerkraftsetzung des persönlichen Informationsspeichers: Die folgenden Schnittstellen und die entsprechenden Methoden wurden hinzugefügt, um das Überschreiben der PSTDisableGrow-Richtlinie des PST-Speicheranbieters (persönliche Ordnerdatei) zu unterstützen:

    IPSTOVERRIDEREQ::IUnknown-

    IPSTOVERRIDE1::IUnknown

  • Verwenden mehrerer Exchange-Konten: Die Dokumentation für die MAPI-Adressbuch-API wurde hinzugefügt. Diese API wurde erweitert, um mehrere Exchange-Konten in Microsoft Outlook 2010 zu unterstützen, und umfasst jetzt Microsoft Outlook 2013. Um Adressen ordnungsgemäß mit mehreren Exchange-Konten zu beheben, verwenden Sie die neuen Funktionen, die einen Konto Kontext ergreifen, damit Anrufe im Adressbuch das richtige Exchange-Konto suchen.

  • MAPI-Dateiformate: Die MAPI-Konfigurationsinformationen wurden erweitert, um zu erläutern, wie Sie Pfade in Registrieren von Diensten und Dienstanbietern in MapiSvc.inf verwenden können.

  • Eigenschaften: Die folgenden markierten Eigenschaften wurden zusätzlich zur Dokumentation für 38 andere markierte Eigenschaften und benannte Eigenschaften hinzugefügt, die zuvor hinzugefügt wurden:

  • MAPI-Konstanten: Die konsolidierten MAPI-Konstanten wurden erweitert. In früheren Versionen wurden sie in einer Reihe von Themen verteilt, sind jetzt aber in einem einzigen Thema gesammelt, damit sie leichter zu entdecken und zu verwenden sind. Sie wurden auch erweitert, um eine umfassendere Abdeckung zu bieten, einschließlich der folgenden Abschnitte:

    • Definitionen für Exchange Adressbuch- und Nachrichtenspeicher-Fehlercodes

    • Definitionen für Kontingente im Exchange Server-Postfachcachemodus

Siehe auch

Erste Schritte mit der Outlook-MAPI-Referenz

MAPIStubLibrary