ITableData : IUnknown
適用対象: Outlook 2013 | Outlook 2016
テーブルを操作するためのユーティリティ メソッドを提供します。 MAPI は、サービス プロバイダーがテーブルメンテナンスを実行するのに役立つ ITableData を実装するテーブル データ オブジェクトまたはオブジェクトを提供します。 テーブル データ オブジェクトを取得するために、サービス プロバイダーは CreateTable 関数を呼び出します。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapiutil.h |
| によって公開される: |
テーブル データ オブジェクト |
| 実装元: |
MAPI |
| 呼び出し元: |
サービス プロバイダー |
| インターフェイス識別子: |
IID_IMAPITableData |
| ポインター型: |
LPTABLEDATA |
Vtable の順序
| メンバー | 説明 |
|---|---|
| HrGetView |
IMAPITable 実装へのポインターを返すテーブル ビューを作成します。 |
| HrModifyRow |
既存の行を置き換える可能性がある、新しいテーブル行を挿入します。 |
| HrDeleteRow |
テーブル行を削除します。 |
| HrQueryRow |
テーブル行を取得します。 |
| HrEnumRow |
テーブル内の位置に基づいて行を取得します。 |
| HrNotify |
テーブル行の通知を送信します。 |
| HrInsertRow |
テーブル行を挿入します。 |
| HrModifyRows |
複数のテーブル行を挿入し、既存の行を置き換える場合があります。 |
| HrDeleteRows |
複数のテーブル行を削除します。 |
注釈
ITableData の MAPI 実装は、すべてのデータと関連する制限をメモリ内に保持することでテーブルと連携し、非常に大きなテーブルでの使用には適しません。 大きな制限事項や、分類などの複雑な操作はサポートされていません。
テーブル データ オブジェクトは、インデックス列を使用して行を識別します。これは、行ごとに一意の値を持つことが保証されるプロパティです。 ほとんどのサービス プロバイダーは、インデックス列として PR_INSTANCE_KEY (PidTagInstanceKey) プロパティを使用します。 複数の値を持つプロパティは、インデックス列として使用できません。
テーブル データ オブジェクトは、変更または削除の影響を受ける行の数に関係なく、1 つの通知を生成します。 操作のターゲット行が存在しない場合は、行が追加されます。