IMAPISupport::GetOneOffTable
適用対象: Outlook 2013 | Outlook 2016
MAPI 1 回限りのテーブルへのポインター (すべてのアドレス帳プロバイダーが新しい受信者の作成をサポートするテンプレートの一覧) を返します。
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
パラメーター
ulFlags
[in]文字列列の型を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_UNICODE
文字列列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列列は ANSI 形式になります。
lppTable
[out]1 回限りのテーブルへのポインター。
戻り値
S_OK
1 回限りのテーブルが正常に取得されました。
注釈
IMAPISupport::GetOneOffTable メソッドは、アドレス帳プロバイダーサポート オブジェクトに実装されます。 アドレス帳プロバイダーは GetOneOffTable を呼び出して、新しい受信者を作成するためのテンプレートの完全な一覧を取得します。 この表には、セッション サポートでアクティブなアドレス帳プロバイダーと、MAPI でサポートされるテンプレートが含まれています。
新しく作成された受信者は、メッセージのアドレス指定に使用することも、アドレス帳コンテナーに追加することもできます。
1 回限りのテーブルで必要な列セットを構成するプロパティの一覧については、「1 回 限りのテーブル」を参照してください。
ulFlags パラメーターでMAPI_UNICODE フラグを設定すると、IMAPITable::QueryColumns メソッドと IMAPITable::QueryRows メソッドから返される列の形式に影響します。 このフラグは、 IMAPITable::QuerySortOrder メソッドによって返される並べ替え順序のプロパティ型も制御します。
呼び出し側への注意
この 1 回限りのテーブルに対する変更の通知を受け取るために登録されている場合は、他のプロバイダーの 1 回限りのテーブルに対する変更の通知も受け取ります。 これらの通知に基づいて、現在のセッション中に追加される新しいアドレスの種類をサポートできます。