IMAPITable::QueryColumns
適用対象: Outlook 2013 | Outlook 2016
テーブルの列の一覧を返します。
HRESULT QueryColumns(
ULONG ulFlags,
LPSPropTagArray FAR * lpPropTagArray
);
パラメーター
ulFlags
[in]返される列セットを示すフラグのビットマスク。 次のフラグを設定できます。
TBL_ALL_COLUMNS
テーブルは、使用可能なすべての列を返す必要があります。
lpPropTagArray
[out]列セットのプロパティ タグを含む SPropTagArray 構造体へのポインター。
戻り値
S_OK
列セットが正常に返されました。
MAPI_E_BUSY
列セット取得操作の開始を妨げる別の操作が進行中です。 進行中の操作の完了を許可するか、停止する必要があります。
注釈
IMAPITable::QueryColumns メソッドを呼び出して、次を取得できます。
テーブルの既定の列セット。
IMAPITable::SetColumns メソッドの呼び出しによって確立されたテーブルの現在の列セット。
テーブルの完全な列セット、使用可能な列、ただし現在のセットの一部であるとは限りません。
呼び出し側への注意
TBL_ALL_COLUMNS フラグを設定しない場合、IMAPITable::QueryColumns は、テーブルが IMAPITable::SetColumns の呼び出しの影響を受けているかどうかに応じて、テーブルの既定または現在の列セットを返します。 SetColumns は 、テーブルの列セット内の列の順序と選択を変更します。
TBL_ALL_COLUMNS フラグを設定した場合、 QueryColumns はテーブルの列セットに含まれるすべての列を返します。
MAPIFreeBuffer 関数を呼び出して、lpPropTagArray パラメーターが指すプロパティ タグ配列のメモリを解放します。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oSetColumns |
MFCMAPI では 、IMAPITable::QueryColumns メソッドを使用して、テーブルの現在の列セットを取得して、ユーザーがテーブルを編集できるようにします。 |