IMessage::GetRecipientTable
適用対象: Outlook 2013 | Outlook 2016
メッセージの受信者テーブルを返します。
HRESULT GetRecipientTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
パラメーター
ulFlags
[in]テーブルの戻り値を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_DEFERRED_ERRORS
呼び出し元のクライアントがテーブルを完全に使用できるようになる前に、 GetRecipientTable が正常に返されるようにします。 テーブルが使用できない場合、後続の呼び出しを行うとエラーが発生する可能性があります。
MAPI_UNICODE
文字列列は Unicode 形式である必要があります。 MAPI_UNICODE フラグが設定されていない場合、文字列列は ANSI 形式である必要があります。
lppTable
[out]受信者テーブルへのポインター。
戻り値
S_OK
受信者テーブルが正常に返されました。
注釈
IMessage::GetRecipientTable メソッドは、メッセージのすべての受信者に関する情報を含む、メッセージの受信者テーブルへのポインターを返します。 受信者ごとに 1 つの行があります。
受信者テーブルの列セットは、メッセージが送信されたかどうかによって異なります。 受信者テーブル内の列の完全な一覧については、「 受信者テーブル」を参照してください。
一部の受信者テーブルでは、さまざまな制限がサポートされています。他の人はしません。 制限のサポートは、メッセージ ストア プロバイダーの実装によって異なります。
ulFlags パラメーターで MAPI_UNICODE フラグを設定すると、受信者テーブルへの次の呼び出しに影響します。
列セットを取得する IMAPITable::QueryColumns。
並べ替え順序を取得する IMAPITable::QuerySortOrder。
Unicode フラグを設定すると、これらの呼び出しから返されるすべての文字列列の情報が Unicode 形式であることを要求します。 ただし、すべてのメッセージ ストア プロバイダーが Unicode をサポートしているわけではないため、このフラグの設定は要求のみです。
呼び出し側への注意
開いている間に受信者テーブルを変更するには、 IMessage::ModifyRecipients メソッドを 呼び出します。 ModifyRecipients は 、受信者の追加、受信者の削除、または受信者のプロパティの変更を行います。