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 vordefinierter Kriterien entsprechen. Da Suchordner Links und keine tatsächlichen Nachrichten enthalten, sind sie tatsächlich schreibgeschützt. Sie dürfen keine anderen Ordner enthalten oder Nachrichten oder Ordner in sie verschieben oder kopieren. 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. Der Eintragsbezeichner PR_ENTRYID (PidTagEntryId) wird von Clients und Dienstanbietern verwendet, um den Ordner zu öffnen. Der Datensatzschlüssel PR_RECORD_KEY (PidTagRecordKey) ist ein Binärwert, der zum Vergleichen 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:
PR_PARENT_ENTRYID (PidTagParentEntryId)
PR_STORE_ENTRYID (PidTagStoreEntryId)
PR_STORE_RECORD_KEY (PidTagStoreRecordKey)
Einige Ordner unterstützen die eigenschaft PR_ACCESS (PidTagAccess), die den Typ der Vorgänge beschreibt, die ein Benutzer ausfü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.