IMsgStore::GetReceiveFolderTable
適用対象: Outlook 2013 | Outlook 2016
受信フォルダー テーブル (メッセージ ストアのすべての受信フォルダーに関する情報を含むテーブル) へのアクセスを提供します。
HRESULT GetReceiveFolderTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable );
パラメーター
ulFlags
[in]テーブル アクセスを制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_DEFERRED_ERRORS
呼び出し元がテーブルを完全に使用できるようになる前に、 GetReceiveFolderTable が正常に返されるようにします。 テーブルが完全に使用できない場合は、後続のテーブル呼び出しを行うとエラーが発生する可能性があります。
MAPI_UNICODE
返される文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式です。
lppTable
[out]受信フォルダー テーブルへのポインターへのポインター。
戻り値
S_OK
受信フォルダー テーブルが正常に返されました。
注釈
IMsgStore::GetReceiveFolderTable メソッドは、メッセージ ストアのすべての受信フォルダーのプロパティ設定を示すテーブルへのアクセスを提供します。
実装に関するメモ
受信フォルダー テーブル内の必要な列の一覧については、「 受信フォルダー テーブル」を参照してください。
PR_RECORD_KEY (PidTagRecordKey) プロパティのプロパティ制限の設定をサポートするために、受信フォルダー テーブルを実装します。 これにより、特定の受信フォルダーに簡単にアクセスできます。
呼び出し側への注意
ulFlags パラメーターでMAPI_UNICODE フラグを設定すると、IMAPITable::QueryColumns メソッドと IMAPITable::QueryRows メソッドから返される列の形式に影響します。 このフラグは、 IMAPITable::QuerySortOrder メソッドによって返される並べ替え順序のプロパティ型も制御します。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnDisplayReceiveFolderTable |
MFCMAPI では 、IMsgStore::GetReceiveFolderTable メソッドを使用して、表示する受信フォルダー テーブルを取得します。 |