IABLogon::GetOneOffTable
適用対象: Outlook 2013 | Outlook 2016
送信メッセージの受信者リストに追加する受信者を作成するための 1 回限りのテンプレートのテーブルを返します。
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
パラメーター
ulFlags
[in]テーブルに含まれる文字列列の種類を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_UNICODE
文字列列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列列は ANSI 形式になります。
lppTable
[out]1 回限りのテーブルへのポインター。
戻り値
S_OK
1 回限りのテーブルが正常に取得されました。
MAPI_E_BAD_CHARWIDTH
MAPI_UNICODE フラグが設定され、アドレス帳プロバイダーが Unicode をサポートしていないか、MAPI_UNICODEが設定されておらず、アドレス帳プロバイダーが Unicode のみをサポートしています。
MAPI_E_NO_SUPPORT
アドレス帳プロバイダーは、1 回限りのテンプレートを提供しません。
注釈
MAPI は GetOneOffTable メソッドを呼び出して、受信者を作成するために使用可能な 1 回限りのテンプレートを作成します。 新しい受信者は、送信メッセージの受信者リストに追加されます。 アドレス帳プロバイダーは、テンプレートの変更を MAPI に通知するために、1 回限りのテーブルでの通知をサポートする必要があります。 MAPI は、動的更新を有効にするために、1 回限りのテーブルを開いたままにします。
アドレス帳プロバイダーは、コンテナーごとに 1 回限りのテーブルをサポートすることもできます。 呼び出し元は、コンテナーの IMAPIProp::OpenProperty メソッドを呼び出し、 PR_CREATE_TEMPLATES (PidTagCreateTemplates) プロパティを要求することで、この 1 回限りのテーブルを取得します。 このテーブルで使用できるテンプレートは、コンテナーに受信者を追加するために使用されます。 2 種類の 1 回限りのテーブルの違いの詳細については、「 One-Off テーブルの実装」を参照してください。
アドレス帳プロバイダーの 1 回限りのテーブルで必要な列の一覧については、「一時 テーブル」を参照してください。