IMAPISession::GetStatusTable
適用対象: Outlook 2013 | Outlook 2016
状態テーブル (セッション内のすべての MAPI リソースに関する情報を含むテーブル) へのアクセスを提供します。
HRESULT GetStatusTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
パラメーター
ulFlags
[in]文字列である列の形式を決定するフラグのビットマスク。 次のフラグを設定できます。
MAPI_UNICODE
文字列列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、文字列列は ANSI 形式になります。
lppTable
[out]状態テーブルへのポインター。
戻り値
S_OK
テーブルが正常に返されました。
注釈
IMAPISession::GetStatusTable メソッドは、セッション内のすべての MAPI リソースに関する情報を含む状態テーブルへのアクセスを提供します。 MAPI サブシステムに関する情報については、テーブル内に 1 行、MAPI スプーラー用に 1 行、統合アドレス帳用に 1 行、プロファイル内のサービス プロバイダーごとに 1 つの行があります。
状態テーブルの必須列と省略可能な列の完全な一覧については、「 Status Tables」を参照してください。
ulFlags パラメーターでMAPI_UNICODE フラグを設定すると、IMAPITable::QueryColumns メソッドと IMAPITable::QueryRows メソッドから返される列の形式に影響します。 このフラグは、 IMAPITable::QuerySortOrder メソッドによって返される並べ替え順序のプロパティ型も制御します。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnStatusTable |
MFCMAPI では、 IMAPISession::GetStatusTable メソッドを使用して、レンダリングされる状態テーブルを取得します。 |