一時テーブルを実装します。Implementing One-Off Tables

適用されます: OutlookApplies to: Outlook

プロバイダーは、1 つまたは複数の一時テーブルを実装できます。Your provider might implement one or more one-off tables. 一時テーブルは、コンテナー内に直接、または送信メッセージの受信者リストに受信者を作成するために使用 1 回限りのテンプレートの概要の一覧です。A one-off table is a summary list of one-off templates used to create recipients, either directly into a container or into the recipient list of an outgoing message. 1 回限りのテンプレートは、アドレスの特定の種類に関連するデータを入力するフォームのユーザーの採用です。A one-off template is a form users employ for entering data relevant to a particular type of address. ユーザーが完了すると、テンプレートを使用する、プロバイダーは新しい受信者を作成し、メッセージに追加します。When the user is finished working with the template, your provider creates the new recipient and adds it to the message. 通常各テンプレートは、1 つのアドレスの種類を処理します。Typically each template handles a single address type. ただし、複数の種類を処理するためのテンプレートまたは同じ型を処理するために複数のテンプレートの使用可能なです。However, it is possible for a template to handle multiple types or for multiple templates to handle the same type.

プロバイダーは、1 回限りの表に含まれる各テンプレートのOpenEntryメソッドをサポートする必要があります。Your provider must support the OpenEntry method for each template that it includes in the one-off table. OpenEntryの実装では、テンプレートの表示テーブルを取得する必要があります。The implementation of OpenEntry should retrieve a display table for the template. MAPI では、表示テーブルを使用して、テンプレートをユーザーに表示されるようにします。MAPI uses the display table to make the template visible to the user.

一時テーブル内の行のほとんどは、テンプレートを表す、分類、またはテンプレートをグループ化する行の一部を使用できます。Although most of the rows in one-off tables represent templates, some of the rows can be used to categorize, or group, templates. 一時テーブル内の行を表すかどうか、テンプレートのPR_SELECTABLE (PidTagSelectable) の列の値が表示されます。Whether or not a row in a one-off table represents a template is indicated by the value of its PR_SELECTABLE (PidTagSelectable) column. テンプレートを表す行がある、[PR_SELECTABLE] 列が TRUE に設定テンプレートではない行には、FALSE に設定することがあります。Rows that represent templates have the PR_SELECTABLE column set to TRUE; rows that do not represent templates have it set to FALSE.

MAPI には、一時テーブルの 3 種類が定義されています。MAPI defines three types of one-off tables:

  • 個々 のコンテナーをサポートしているテンプレートを反映する一時テーブルA one-off table that reflects the templates that an individual container supports

  • 一時テーブルのすべてのプロバイダーをサポートしているテンプレートを反映します。A one-off table that reflects all of the templates that your provider supports

  • 一時テーブルのすべてのすべてのプロファイル プロバイダーをサポートするいると、いくつか MAPI をサポートしているテンプレートを反映します。A one-off table that reflects all of the templates that all of the providers in the profile support plus some that MAPI supports

作成受信者、メッセージの上にまたはコンテナーのいずれかをサポートするプロバイダーによっては、最初の 2 種類が実装されています。The first two types are implemented by providers that support the creation recipients, either onto a message or into a container. プロバイダーは、その一時テーブルで同じまたは別のテンプレートのセットを含めることができます。Your provider can include the same set or a different set of templates in its one-off tables. 2 種類の主な違いは、プロバイダーのテーブルには、送信メッセージで使用できる受信者を作成するためのテンプレートを含める必要があります、そのコンテナーのテーブルには、コンテナーに追加する受信者を作成するためのテンプレートを含める必要があります。The main difference between the two types is that your provider table should include templates for creating recipients that can be used on outgoing messages and your container table should include templates for creating recipients to be added to your container. コンテナーが制限された一連のテンプレートをサポートするだけで、プロバイダーの一時テーブルは、プロバイダーのすべてのテンプレートを含める必要がありますをサポートしています。A container may only support a restricted set of templates, but the provider one-off table should include every template the provider supports.

一時テーブルの 3 番目の型は、MAPI のによって実装します。プロバイダーでは、 IMAPISupport::GetOneOffTableを呼び出すことによってアクセスができます。The third type of one-off table is implemented by MAPI; providers gain access to it by calling IMAPISupport::GetOneOffTable. MAPI の一時テーブルでは、プロバイダーのテーブルのすべての和集合です。プロファイル内のすべてのプロバイダーでサポートされているすべてのテンプレートが含まれています。The MAPI one-off table is the union of all of the provider tables; it includes every template supported by every provider in the profile. MAPI がサポートされているテンプレートも含まれています。It also includes templates supported by MAPI. プロバイダーでは、コンテナーの要求されたテーブルではなくこのテーブルを使用できます。Your provider can use this table in place of the table requested for a container. ただし、テンプレートを次の表では、送信メッセージの受信者を作成するのにも使用できます。However, the templates in this table can also be used for creating recipients for outgoing messages.