Freigeben über

MAPI-Ordner

Gilt für: Outlook 2013 | Outlook 2016

Ordner sind MAPI-Objekten, die als Basiseinheit Organisation für Nachrichten zu bedienen. Hierarchisch angeordnet sind, können Ordner Nachrichten und andere Ordner enthalten. Ordner erleichtern das Suchen von und Arbeiten mit Nachrichten.

Ordner implementieren Sie die IMAPIFolder -Schnittstelle, die indirekt von der IUnknown -Schnittstelle, durch die IMAPIContainer und IMAPIProp Schnittstellen erbt. Clients verwenden IMAPIFolder erstellen, kopieren und Löschen von Nachrichten und Ordnern, abrufen und Festlegen des Nachrichtenstatus, und so festlegen oder Aufheben der Kennzeichnung Lesen einer Nachricht. Obwohl Nachricht-Anbieter zur Unterstützung aller Methoden in IMAPIFoldererforderlich sind, stellen Sie einige Methoden Maß an Komplexität, die Nachricht Anbieter vermeiden möchten möglicherweise vor. MAPI sparen-Anbieter Nachricht einige Arbeit einige komplexere Ordner Funktionen in der IMAPISupport -Schnittstelle implementieren. Anstatt einen eigenen Kopie-Methoden implementieren, beispielsweise können Nachricht Anbieter rufen die Methoden Kopie im Support-Objekt und die gleichen Ergebnisse erhalten möchten.

Es gibt drei Arten von Ordnern:

  • Stammordner.

  • Generische Ordner.

  • Suchordner

Jeder Nachrichtenspeicher hat mindestens eine Stammordner. Stammordner wird oben in der Hierarchie und Nachrichten und andere Ordner enthält. Stammordner können nicht verschoben, kopiert, umbenannt oder gelöscht werden. Es gibt nur eine Stammordner für jeden Nachrichtenspeicher.

Die meisten anderen Ordner sind generische Ordner. Generische Ordner enthalten wie Stammordner Nachrichten und anderen Ordner. Im Gegensatz zum Stammordner können sie verschoben, kopiert, umbenannt und gelöscht werden. Generische Ordner können in den Stammordner oder andere generische Ordner erstellt werden. Wenn ein Client einen generischen Ordner in einem anderen Ordner erstellt, wird der neue Ordner einen Unterordner oder untergeordneten Ordner aufgerufen. Der Ordner, in dem Sie der neue Ordner befindet, wird als des übergeordneten Ordners des neuen Ordners bezeichnet. Generische Ordner mit dem gleichen übergeordneten Ordner werden als gleichgeordnete Ordner bezeichnet. Gleichgeordneten Knoten und nicht gleichgeordnete Ordner möglicherweise oder möglicherweise nicht eindeutige Namen haben, je nach der Nachricht Speicheranbieter. Nachricht-Anbieter, die gleichgeordnete Ordner haben eindeutige Namen den Fehlerwert MAPI_E_COLLISION zurück, wenn ein Client versucht, erstellen Sie zwei Ordner mit dem gleichen Namen in der gleichen übergeordneten erfordern.

Ein Suchordner enthält Links zu Nachrichten, die einer Reihe von vordefinierten Kriterien entsprechen. Da Suchordner eher Links als tatsächliche Nachrichten enthalten, sind sie eigentlich schreibgeschützt. Sie können keine anderen Ordner enthalten und es können keine Nachrichten oder Ordner in sie verschoben oder kopiert werden. In ihnen können keine neuen Nachrichten erstellt werden, und sie selbst können nicht verschoben, kopiert oder umbenannt werden. Wenn eine Nachricht aus einem Suchordner gelöscht wird, wird sie tatsächlich aus dem Ordner gelöscht, der die Nachricht enthält.

Der Ordnertyp wird in der Eigenschaft PR_FOLDER_TYPE (PidTagFolderType) gespeichert. Jeder Ordner hat diese Eigenschaft auf FOLDER_GENERIC, FOLDER_ROOT oder FOLDER_SEARCH, je nachdem dieses Typs festgelegt.

Jeder Ordner verfügt über eine Eintrags-ID und einen Datensatzschlüssel. Die Eintragskennung, PR_ENTRYID (PidTagEntryId), wird von Clients und Dienstanbietern zum Öffnen des Ordners verwendet. Der Datensatzschlüssel, PR_RECORD_KEY (PidTagRecordKey), ist ein binärer Wert, der zum Vergleich des Ordners mit anderen Ordnern verwendet wird.

Ein Ordner hat andere Eigenschaften zugehörigen Ordner und den Nachrichtenspeicher zu identifizieren. Die folgenden Eigenschaften sind erforderlich:

Einige Ordner unterstützen die Eigenschaft PR_ACCESS (PidTagAccess), die die Art der Operationen beschreibt, die ein Benutzer durchführen kann. Beispielsweise ist eine der gültigen Einstellungen für PR_ACCESS MAPI_ACCESS_DELETE, die angibt, dass der Ordner entfernt werden kann. Eine weitere Einstellung, MAPI_ACCESS_MODIFY, gibt an, dass der Ordner geändert werden.

Eine vollständige Liste der erforderlichen Ordnereigenschaften finden Sie unter der IMAPIFolder -Schnittstelle.

Siehe auch

MAPI-Anwendungsentwicklung