CLI の手引きおよび解説書

SQLFreeEnv - 環境ハンドルの解放

DB2 CLI バージョン 5 以降におけるこの関数の状況
注:

ODBC バージョン 3 では、SQLFreeEnv() は使用すべきではありません。代わりに、SQLFreeHandle() に置き換えられています。詳細については、 SQLFreeHandle - ハンドル資源を解放するを参照してください。

このバージョンの DB2 CLI でも引き続き SQLFreeEnv() をサポートしていますが、 SQLFreeHandle() の使用を DB2 CLI プログラムから開始するなら最新の規格に適合できるため、この方法をお勧めします。

上記の関数と、その他の使用すべきでない関数の詳細については、 バージョン 5 で使用すべきでない DB2 CLI 関数を参照してください。

新しい関数への移行

たとえば、次の旧ステートメント

   SQLFreeEnv(henv);
は、新しい関数を使用して、以下のように書き換えます。
   SQLFreeHandle(SQL_HANDLE_ENV, henv);

目的
仕様: DB2 CLI 1.1 ODBC 1.0 ISO CLI

SQLFreeEnv() は、環境ハンドルを無効にし、解放します。環境ハンドルに関連したすべての DB2 CLI 資源が解放されます。

この関数を呼び出す前に、SQLFreeConnect() を呼び出す必要があります。

この関数は、アプリケーションが終了前に行われなければならない最後の DB2 CLI ステップです。

構文

SQLRETURN   SQLFreeEnv       (SQLHENV           henv);

関数引き数

表 84. SQLFreeEnv 引き数
データ・タイプ 引き数 使用法 説明
SQLHENV henv 入力 環境ハンドル

使用法

有効な接続ハンドルがまだ存在しているときにこの関数を呼び出すと、 SQL_ERROR が返され、環境ハンドルはそのまま有効です。

戻りコード

診断

表 85. SQLFreeEnv SQLSTATE
SQLSTATE 説明 解説
58004 予期しないシステム障害です。 回復不能システム・エラー。
HY001 メモリーの割り振り失敗です。 DB2 CLI は、関数の実行または完了をサポートするのに必要なメモリーを割り振ることができません。
HY010 関数の順序エラーです。 割り当てられた状態または接続された状態の hdbc があります。 SQLFreeEnv() を呼び出す前に、hdbcSQLDisconnect()SQLFreeConnect() を呼び出してください。
HY013 予期しないメモリーのハンドル・エラーが起きました。 DB2 CLI は、関数の実行または完了をサポートするのに必要なメモリーを使用することができませんでした。

許可

なし。

SQLFreeHandle - ハンドル資源を解放するを参照してください。

参照


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]