Neu in dieser Edition (engl.)
Gilt für: Outlook 2013 | Outlook 2016
Die Microsoft Outlook MAPI-Referenz wurde aktualisiert, um Dokumentationen für verschiedene neue Features einzuschließen.
Neuer Inhalt
Für die folgenden Features wurden Inhalte hinzugefügt:
Das Thema Erste Schritte mit der Outlook 2013 MAPI-Referenz wurde aktualisiert, um auf umfassende Informationen zu Programmiermodellen für Ihre Outlook- und MAPI-Funktionen zu verweisen, damit Sie die APIs und Technologien identifizieren können, die am besten für Ihre Anforderungen geeignet sind. Links zu dem referenzierten technischen Artikel wurden auch in den folgenden Themen überarbeitet:
Beispiel für Nachrichtenspeicheranbieter– Der Beispielcode für den umschlossenen PST-Speicheranbieter wurde jetzt überarbeitet, um Outlook 2013 zu erkennen und zu berücksichtigen. Weitere Informationen finden Sie unter Zuvor überarbeiteter Inhalt in diesem Thema.
AutoVervollständigen Stream – Das Cachethema "Spitzname", früher Nk2-Dateiformat, wurde aktualisiert, um Änderungen in Outlook 2013 und Outlook 2010 widerzuspiegeln. Die folgenden Themen wurden nun überarbeitet, um Informationen zu den .nk2-Dateiformat-Entwicklerrichtlinien für Microsoft Outlook 2003/Microsoft Office Outlook 2007 und die Analyse von Binärdateien bereitzustellen. Weitere Informationen finden Sie unter Zuvor überarbeiteter Inhalt in diesem Thema.
Schnittstellen: Das Thema IAddrBook::OpenEntry dokumentiert eine Methode zum Öffnen eines Adressbucheintrags und zurückgeben eines Zeigers auf die Schnittstelle, die für den Zugriff verwendet wird. Es enthielt zuvor ein Flag im ulFlags-Parameter, MAPI_GAL_ONLY, das nur zum Öffnen der globalen Adressliste (GAL) verwendet werden konnte, und wurde überarbeitet, um seine Definition einzuschließen.
Eigenschaften– Das Thema PR_CONVERSATION_KEYbenannte Eigenschaft (kanonische PidTagConversationKey-Eigenschaft) wurde hinzugefügt und bezieht sich auf IPM. MessageManager-Nachrichten nur in Outlook MAPI. Die folgenden Themen, die sich darauf beziehen, und die Dokumentation zum Transport-Neutral Kapselungsformat (TNEF) wurden überarbeitet:
MAPI-Initialisierungsmonitor
- Es kann vorkommen, dass eine Anwendung, die MAPI nutzt, wissen möchte, wann die Initialisierung abgeschlossen ist. Beispielsweise verfügt sie über mehrere Threads, die MAPI initialisieren könnten, oder als Reaktion auf die MAPI-Initialisierung möchte die Anwendung einige Aufgaben ausführen, aber nicht immer den MAPI-Stapel starten. Der Initialisierungsmonitor stellt diese Funktionalität über eine Funktion (exportiert aus OLMAPI32.DLL) und einige einfache Schnittstellen bereit, die unten beschrieben werden.
HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)
- Dies ist ein Einstiegspunkt, der aus OLMAPI32.DLL dies dem Aufrufer ermöglicht, eine Schnittstelle abzurufen, um den aktuellen Initialisierungszustand abzufragen, einen Rückruf für den Abschluss der Initialisierung einzurichten oder den aktuellen Thread zu blockieren, bis abgeschlossen ist. Das von dieser API zurückgegebene Objekt ist wiederverwendbar und threadsicher und kann von jedem Thread aufgerufen werden, nicht nur von Einem Thread, der es abgerufen hat. Im Gegensatz zu anderen Objekten, die über MAPI verfügbar gemacht werden, ist dieses Objekt außerdem gültig, solange die DLL geladen wird, kann es in Initialisierungssitzungen wiederverwendet und vor oder nach dem Aufruf von MAPIInitialize genutzt werden. Gibt einen Erfolg oder Fehler über ein COM-Standard-HRESULT zurück und weist einem instance 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 entweder zurückgibt, wenn die angegebene Anzahl von Millisekunden abgelaufen ist oder MAPI initialisiert wurde. INFINITE kann für eine unendliche Wartezeit verwendet werden.
IFACEMETHODIMP BeginWait(DWORD timeout, IMAPIWaitResult ppResult)
- Starten Sie eine Wartezeit, bis die MAPI-Initialisierung oder die angegebene Anzahl von Millisekunden verstrichen ist. Dadurch wird eine IMAPIWaitResult-Schnittstelle zurückgegeben, für die "End" aufgerufen werden sollte, um den Wartevorgang zu beginnen. Dadurch kann der Aufrufer steuern, welcher Thread blockiert wird, während wir warten.
Schnittstelle IMAPIWaitResult
IFACEMETHODIMP End()-Außerkraftsetzung
- Wird aufgerufen, um das Blockieren des Wartevorgangs für den Thread zu initiieren, in dem er aufgerufen wird, muss nicht derselbe Thread sein, der "BeginWait" aufgerufen hat.
Zuvor überarbeitete Inhalte
Inhalt wurde in früheren Versionen der Outlook MAPI-Referenz für die folgenden Features hinzugefügt:
Microsoft Outlook 2013 ermöglicht nicht herkömmliche Bereitstellungsszenarien wie nebeneinander und Klick-und-Run. Diese Szenarien können die Logik zum Laden der richtigen MAPI-Bibliothek erschweren. MAPI-Entwickler haben jetzt die Möglichkeit, eine explizite Verknüpfung mit MAPI-Funktionen zu erstellen, und können explizit eine 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 zu impliziten Verknüpfungen finden Sie unter Link zu MAPI-Funktionen.
Die MAPI Stub Library, die auf MAPIStubLibrary auf GitHub veröffentlicht wurde, bietet einen Drop-In-Ersatz für Mapi32.lib, der sowohl das Erstellen von 32-Bit- als auch 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. Ein neues Codebeispiel wurde unter Überprüfen der Version von Outlook bereitgestellt, um zu zeigen, wie Sie ü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 Beispielanbieter für umschlossenen PST-Speicher wurde zuvor aktualisiert, um die 64-Bit-Architektur zu unterstützen. Das Thema Initialisieren eines umschlossenen PST-Speicheranbieters im Beispiel wurde nun erweitert, um Informationen zu den "umschlossenen PST- und Unicode-Pfaden" bereitzustellen.
AutoVervollständigen Stream – Das Cachethema "Spitzname", vormals 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 Bearbeitungsfeldern An, Cc und Bcc angezeigt werden, während ein Benutzer eine E-Mail verfasst, werden jetzt im AutoVervollständigen-Stream einer Nachricht auf dem lokalen Computer gespeichert, anstatt sie wie in Outlook 2007 in einer Datei zu speichern.
Interaktion mit dem AutoVervollständigen-Stream
Laden der autovervollständigen-Stream
Speichern der autovervollständigen-Stream
Unterstützung für schnelles Herunterfahren für MAPI-Clients: MAPI-Clients können jetzt ein schnelles Herunterfahren initiieren und das MAPI-Subsystem die geladenen Anbieter benachrichtigen lassen, um Datenverluste aufgrund des schnellen Herunterfahrens zu minimieren. Für den Client und den Anbieter wurden zusätzliche Schnittstellen hinzugefügt, um das schnelle Herunterfahren zu unterstützen. Weitere Informationen zum schnellen Herunterfahren finden Sie unter Herunterfahren von Clients in MAPI.
Stream-Struktur für Felddefinitionen für ein Outlook-Element – 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 Speichers– Die folgenden Schnittstellen und ihre entsprechenden Methoden wurden hinzugefügt, um das Überschreiben der PST-Richtlinie (Personal Folders File) des PstDisableGrow-Speicheranbieters zu unterstützen:
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– MapI-Konfigurationsinformationen wurden erweitert, um zu erläutern, wie Sie Pfade unter Registrieren von Diensten und Dienstanbietern in MapiSvc.inf verwenden können.
Eigenschaften – Die folgenden markierten Eigenschaften wurden zusätzlich zur Dokumentation für 38 weitere 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, werden jetzt aber in einem einzelnen Thema gesammelt, um sie einfacher zu erkennen und zu verwenden. Sie wurden auch erweitert, um eine umfassendere Abdeckung einschließlich der folgenden Abschnitte zu bieten:
Definitionen für Exchange-Adressbuch- und Nachrichtenspeicherfehlercodes
Definitionen für Exchange Server Kontingente im Modus "Postfachcached"