MAPI のプロパティの概要
適用対象: Outlook 2013 | Outlook 2016
プロパティは MAPI オブジェクトの属性です。 プロパティは、メッセージの件名行やメッセージング ユーザーのアドレスの種類など、オブジェクトに関する何かを表します。 MAPI は多くのプロパティを定義します。一部は多くのオブジェクトを記述し、特定の型のオブジェクトにのみ適したプロパティを定義します。 クライアントとサービス プロバイダーは、新しいカスタム プロパティを作成することで、MAPI の定義済みプロパティのセットを拡張できます。 クライアントは、新しいメッセージ クラスを記述するプロパティを定義でき、サービス プロバイダーは、メッセージング システムの一意の機能を公開するプロパティを定義できます。
プロパティは永続的または一時的です。 セッションからセッションに保持されるプロパティは、オブジェクトのデータまたはプロファイルに格納できます。 一時プロパティは、現在のセッションの期間中にのみ存在します。
クライアントとサービス プロバイダーは、テーブルまたはプロパティ シートを持つユーザーにプロパティを表示できます。 テーブルを使用すると、複数のオブジェクトに属するプロパティの一部を読み取り専用で表示できます。 データは行と列の形式で表示され、各行はオブジェクトと各列にプロパティを表します。 プロパティ シートは、1 つのオブジェクトの関連プロパティを表示するタブ付きダイアログ ボックスです。 プロパティ シートは、データへの読み取り専用または読み取り/書き込みアクセスを提供できます。 ユーザーが変更を許可されるかどうかは、プロパティ シートの実装者次第です。
IMAPIProp インターフェイスは、プロパティを操作するためのプライマリ インターフェイスです。 プロパティをサポートするすべてのオブジェクトは 、IMAPIProp を実装します。 IMAPIProp には、プロパティ値の取得、プロパティのコピー、変更の作成と保存、プロパティ名とその識別子間のマッピング、および以前のエラーに関する情報の取得を行うメソッドが含まれています。
プロパティとプロパティに関する情報を記述するためのデータ構造がいくつかあります。 最も一般的に使用される構造体は、 SPropValue 構造体と SPropTagArray 構造体です。 SPropValue 構造体には、プロパティを記述する 3 つの情報が含まれています。
プロパティのデータ (値)。
整数やブール値など、プロパティの値のデータ型。
プロパティとそれを維持するコンポーネントを一意に識別する特定の範囲内の数値。 たとえば、MAPI で定義されたメッセージ コンテンツ プロパティを保持する範囲と、カスタム メッセージ クラスのクライアントによって定義されたメッセージ コンテンツ プロパティを保持する別の範囲があります。
プロパティの型と識別子は、プロパティ タグと呼ばれる 1 つのコンポーネントに結合されます。 プロパティ タグは、プロパティを簡単に参照するために使用できる定数です。 MAPI によって定義されたプロパティのプロパティ タグは、MAPITAGS に含まれています。H ヘッダー ファイルと、SPropValue 構造体の ulPropTag メンバー内。 クライアントとサービス プロバイダーは、プロパティ タグを使用して、対応するプロパティを識別、取得、更新します。
SPropTagArray 構造体は、プロパティ タグのカウントされた配列です。 IMAPIProp やその他のインターフェイスのメソッドの多くは、プロパティを記述するために SPropTagArray 構造体を使用します。