MAPI �t�H���_�[
適用対象: Outlook 2013 | Outlook 2016
Folders are MAPI objects that serve as the basic unit of organization for messages. Arranged hierarchically, folders can contain messages and other folders. Folders make it easier to locate and work with messages.
Folders implement the IMAPIFolder interface, which indirectly inherits from the IUnknown interface through the IMAPIContainer and IMAPIProp interfaces. Clients use IMAPIFolder to create, copy, and delete messages and folders, to retrieve and set message status, and to set or clear the read flag for a message. Although message store providers are required to support all the methods in IMAPIFolder, some methods introduce a level of complexity that message store providers might want to avoid. MAPI saves message store providers some work by implementing some of the more complex folder functionality in the IMAPISupport interface. Rather than implementing their own copy methods, for example, message store providers can call the copy methods in the support object and get the same results.
�t�H���_�[�� 3 ��ނ�����܂��B
���[�g �t�H���_�[�ɂ��܂��B
�ėp�t�H���_�[�ɂ��܂��B
�t�H���_�[��������܂��B
Every message store has at least a root folder. The root folder appears at the top of the hierarchy and contains messages and other folders. Root folders cannot be moved, copied, renamed, or deleted. There is only one root folder for each message store.
Most other folders are generic folders. Like root folders, generic folders contain messages and other folders. Unlike root folders, they can be moved, copied, renamed, and deleted. Generic folders can be created in the root folder or other generic folders. When a client creates a generic folder in another folder, the new folder is called a subfolder, or child folder. The folder in which the new folder is placed is referred to as the parent folder of the new folder. Generic folders that have the same parent folder are called sibling folders. Both sibling and non-sibling folders may or may not have unique names, depending on the message store provider. Message store providers that require sibling folders to have unique names return the error value MAPI_E_COLLISION when a client attempts to create two folders with the same name in the same parent.
A search folder contains links to messages that match a set of predefined criteria. 検索フォルダーには実際のメッセージではなくリンクが含まれているため、実際には読み取り専用です。 他のフォルダーを含めたり、メッセージやフォルダーを移動したり、フォルダーにコピーしたりすることはできません。 新しいメッセージを作成することはできません。また、移動、コピー、または名前の変更はできません。 検索フォルダーからメッセージが削除されると、メッセージを含むフォルダーから実際に削除されます。
フォルダーの種類は、 PR_FOLDER_TYPE (PidTagFolderType) プロパティに格納されます。 すべてのフォルダーには、その種類に応じて、このプロパティが FOLDER_GENERIC、FOLDER_ROOT、またはFOLDER_SEARCHに設定されています。
すべてのフォルダーには、1 つのエントリ識別子と 1 つのレコード キーがあります。 エントリ識別子 (PR_ENTRYID (PidTagEntryId) は、クライアントとサービス プロバイダーによってフォルダーを開くために使用されます。 レコード キー (PR_RECORD_KEY (PidTagRecordKey) は、フォルダーを他のフォルダーと比較するために使用されるバイナリ値です。
フォルダーには、関連するフォルダーとメッセージ ストアを識別するための他のプロパティがあります。 次のプロパティが必要です。
PR_PARENT_ENTRYID (PidTagParentEntryId)
PR_STORE_ENTRYID (PidTagStoreEntryId)
PR_STORE_RECORD_KEY (PidTagStoreRecordKey)
一部のフォルダーでは、ユーザーが実行できる操作の種類を記述する PR_ACCESS (PidTagAccess) プロパティがサポートされています。 たとえば、 PR_ACCESS の有効な設定の 1 つがMAPI_ACCESS_DELETEされ、フォルダーを削除できることを示します。 別の設定 (MAPI_ACCESS_MODIFY) は、フォルダーを変更可能にする必要があることを示します。
必要なフォルダー プロパティの完全な一覧については、 IMAPIFolder インターフェイスを参照してください。