FindColumnメソッド

機能

フィールド名称に対応するフィールドのインデクスを取得します。

形式

UINT32 FindColumn(LPCTSTR lpctFieldName) throw DBSQLCA

引数

lpctFieldName

フィールド名を指定します。

なお,SELECT文でフィールド演算や,COUNTなどの関数を使用した場合,フィールド名はデータベースによって決められます。このような場合にフィールド名を調べるためには,DBResultSetMetaDataオブジェクトのGetColumnNameメソッドを呼び出します。

戻り値

データ型:UINT32

フィールドの番号を取得します。

機能詳細

指定されたフィールド名に対応したフィールド番号を取得します。

フィールド番号は,SQL文中での出現順に割り当てられます。

引数に指定されたフィールド名がDBResultSetオブジェクト中で重複していた場合,FindColumnメソッドは最初に検索したフィールド番号(フィールド番号の最も若いもの)を返します。

発生する例外

DBSQLCA(RetCode)

DB_ERROR_NOT_ENOUGH_MEMORY
メモリ容量が不足しています。
DB_ERROR_RESULTSET_NOT_EXIST
非同期実行時に,検索結果がまだ取得できていません。
DB_ERROR_NOT_FOUND
指定したフィールドが見つかりません。
DB_ERROR_CANNOT_BE_NULL
引数lpctFieldNameにNULLを指定しています。