IMAPITable::QueryColumnsIMAPITable::QueryColumns

適用対象: Outlook 2013 | Outlook 2016Applies to: Outlook 2013 | Outlook 2016

テーブルの列のリストを返します。Returns a list of columns for the table.

HRESULT QueryColumns(
ULONG ulFlags,
LPSPropTagArray FAR * lpPropTagArray
);

パラメーターParameters

ulFlagsulFlags

順番返される列セットを示すフラグのビットマスク。[in] Bitmask of flags that indicates which column set should be returned. 次のフラグを設定できます。The following flag can be set:

TBL_ALL_COLUMNSTBL_ALL_COLUMNS

テーブルは使用可能なすべての列を返します。The table should return all available columns.

lpPropTagArraylpPropTagArray

読み上げ列セットのプロパティタグを含むSPropTagArray構造体へのポインター。[out] Pointer to an SPropTagArray structure containing the property tags for the column set.

戻り値Return value

S_OKS_OK

列セットが正常に返されました。The column set was successfully returned.

MAPI_E_BUSYMAPI_E_BUSY

別の操作が進行中であるため、列セットの取得操作を開始できません。Another operation is in progress that prevents the column set retrieval operation from starting. 進行中の操作が完了することを許可するか、停止する必要があります。Either the operation in progress should be allowed to complete or it should be stopped.

注釈Remarks

IMAPITable:: querycolumnsメソッドを呼び出すと、次のものを取得できます。The IMAPITable::QueryColumns method can be called to retrieve:

  • テーブルの既定の列セット。The default column set for a table.

  • IMAPITable:: SetColumnsメソッドの呼び出しによって確立された、テーブルの現在の列セット。The current column set for a table, as established by a call to the IMAPITable::SetColumns method.

  • テーブルの完全な列セット。使用可能な列ですが、現在のセットの一部ではありません。The complete column set for a table, the columns that are available, but not necessarily part of the current set.

呼び出し側への注意Notes to callers

TBL_ALL_COLUMNS フラグを設定しない場合、 imapitable:: querycolumnsは、テーブルの既定または現在の列セットを返します。これは、テーブルがIMAPITable:: SetColumnsの呼び出しの影響を受けたかどうかによって決まります。If you do not set the TBL_ALL_COLUMNS flag, IMAPITable::QueryColumns returns either a table's default or current column set, depending on whether the table has been affected by a call to IMAPITable::SetColumns. SetColumnsは、テーブルの列セット内の列の順序と選択範囲を変更します。SetColumns changes the order and selection of columns in a table's column set.

TBL_ALL_COLUMNS フラグを設定した場合、 querycolumnsは、テーブルの列セットに設定可能なすべての列を返します。If you set the TBL_ALL_COLUMNS flag, QueryColumns returns all of the columns that are capable of being in the table's column set.

MAPIFreeBuffer関数を呼び出して、 _lpPropTagArray_パラメーターによって示されるプロパティタグ配列のメモリを解放します。Free the memory for the property tag array pointed to by the lpPropTagArray parameter by calling the MAPIFreeBuffer function.

MFCMAPI リファレンスMFCMAPI reference

MFCMAPI のサンプル コードについては、次の表を参照してください。For MFCMAPI sample code, see the following table.

ファイルFile 関数Function コメントComment
ContentsTableListCtrlContentsTableListCtrl.cpp
CContentsTableListCtrl::D osetcolumnsCContentsTableListCtrl::DoSetColumns
mfcmapi は、 IMAPITable:: querycolumnsメソッドを使用して、テーブルの現在の列セットを取得し、ユーザーが編集できるようにします。MFCMAPI uses the IMAPITable::QueryColumns method to retrieve the current column set for a table so the user can edit it.

関連項目See also

IMAPITable::SetColumnsIMAPITable::SetColumns

MAPIFreeBufferMAPIFreeBuffer

SPropTagArraySPropTagArray

IMAPITable : IUnknownIMAPITable : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample