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
);

�p�����[�^�[Parameters

ulFlagsulFlags

[in]のどの列の設定を示すフラグのビットマスクが返されます。[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

[out]列のプロパティ タグを含むSPropTagArray構造体へのポインターを設定します。[out] Pointer to an SPropTagArray structure containing the property tags for the column set.

�߂�lReturn 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 �T���v�� �R�[�h�ł́A���̕\��Q�Ƃ��Ă��������BFor MFCMAPI sample code, see the following table.

�t�@�C��File �֐�Function �R�����gComment
ContentsTableListCtrl.cppContentsTableListCtrl.cpp
CContentsTableListCtrl::DoSetColumnsCContentsTableListCtrl::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