コア レベルの API 関数 (ODBC Driver for Oracle)
重要
この機能は、Windows の将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに、Oracle によって提供される ODBC ドライバーを使用してください。
このレベルの関数は、ODBC ドライバーのインターフェイス準拠の最小レベルで構成されます。
| API 関数 | メモ |
|---|---|
| SQLAllocConnect | henv によって識別される環境内の接続ハンドル hdbc にメモリを割り当てます。 ドライバー マネージャーは、この呼び出しを処理し、SQLConnect、SQLBrowseConnect、または SQLDriverConnect が呼び出されるたびに、ドライバーの SQLAllocConnect 関数を呼び出します。 |
| SQLAllocEnv | Oracle クライアント ソフトウェアの要件を指定するダイアログ ボックスを表示し、SQL_NULL_HANDLE を返します。 Oracle クライアント ソフトウェアがインストールされていない場合、この関数は環境ハンドル (henv) にメモリを割り当て、アプリケーションで使用する ODBC コール レベル インターフェイスを初期化します。 |
| SQLAllocStmt | ステートメント ハンドルにメモリを割り当て、ステートメント ハンドルを hdbc で指定された接続に関連付けます。 ドライバー マネージャーは、hstmt 構造のメモリを割り当てるドライバーにこの呼び出しを渡します。 |
| SQLBindCol | 結果列の記憶領域を割り当て、結果の種類を指定します。 |
| SQLCancel | ステートメント ハンドル hstmt の処理をキャンセルします。 場合によっては、Oracle では実行中のステートメントのキャンセルは許可されません。 つまり、実行中のステートメントは、Oracle がプロセスを完了するまで続行され、その時点で ODBC Driver for Oracle によってステートメントの結果がキャンセルされます。 |
| SQLColAttributes | 結果セット内の列の記述子情報を返します。 記述子情報は、文字列、32 ビット記述子依存値、または整数値として返されます。 |
| SQLConnect | データ ソースに接続します。 Oracle オペレーティング システム認証を使用するには、szUID パラメーターとして "/" を、szAuthStr パラメーターとして "" を指定します。 |
| SQLDescribeCol | 指定された結果列の名前、型、有効桁数、小数点以下桁数、および NULL 値の許容を返します。 注: SQLDescribeCol は 、計算列を SQL_VARCHAR としてレポートします。 |
| SQLDisconnect | 接続を閉じます。 共有環境に対して接続プールが有効になっていて、アプリケーションがその環境の接続で SQLDisconnect を呼び出した場合、接続は接続プールに返され、同じ共有環境を使用して他のコンポーネントで引き続き使用できます。 |
| SQLError | 最後のエラーに関するエラーまたは状態の情報を返します。 ドライバーは、SQLError の呼び出し方法に応じて、hstmt、hdbc、および henv 引数に対して返すことができるエラーのスタックまたはリストを保持します。 エラー キューは、各ステートメントの後にフラッシュされます。 通常は Oracle エラー メッセージを取得し、それ以外の場合は空です。 |
| SQLExecDirect | 準備されていない新しい SQL ステートメントを実行します。 ステートメントにパラメーターが存在する場合、ドライバーはパラメーター マーカー変数の現在の値を使用します。 テーブル、ビュー、またはフィールド名にスペースが含まれている場合は、名前をバック クォート記号で囲みます。 たとえば、データベースに My Table という名前のテーブルとフィールド My Field が含まれている場合は、識別子の各要素を次のように囲みます。 SELECT `My Table`. `My Field1`,; `My Table`.`My Field2` FROM `My Table` |
| SQLExecute | 準備された SQL ステートメント (SQLPrepare によって既に準備されているステートメント) を実行します。 ステートメントにパラメーターが存在する場合、ドライバーはパラメーター マーカー変数の現在の値を使用します。 |
| SQLFetch | SQLBindCol の前の呼び出しで指定された場所に、結果セットから 1 つの行を取得します。 バインドされていない列の SQLGetData への呼び出しのためにドライバーを準備します。 |
| SQLFreeConnect | 接続ハンドルを解放し、ハンドルに割り当てられているすべてのメモリを解放します。 |
| SQLFreeEnv | ODBC Driver for Oracle を閉じ、ドライバーに関連付けられているすべてのメモリを解放します。 |
| SQLFreeStmt | 特定の hstmt に関連付けられている処理を停止し、hstmt に関連付けられている開いているカーソルを閉じ、保留中の結果を破棄し、必要に応じてステートメント ハンドルに関連付けられているすべてのリソースを解放します。 |
| SQLGetCursorName | 指定された hstmt に関連付けられているカーソルの名前を返します。 |
| SQLNumResultCols | 結果セット カーソル内の列数を返します。 |
| SQLPrepare | ステートメントを最適化して実行する方法を計画して、SQL ステートメントを準備します。 SQL ステートメントは、SQLExecDirect による実行のためにコンパイルされます。 テーブル、ビュー、またはフィールド名にスペースが含まれている場合は、名前をバック クォート記号で囲みます。 たとえば、データベースに My Table という名前のテーブルとフィールド My Field が含まれている場合は、識別子の各要素を次のように囲みます。 SELECT 'My Table'.'My Field' FROM 'My Table' 正式なパラメーターとして配列を含む結果セットを使用する方法については、「ストアド プロシージャから配列パラメーターを返す」を参照してください。 |
| SQLRowCount | Oracle では、最後の行をフェッチした後まで結果セット内の行数を決定する方法は提供されていないため、-1 が返されます。 |
| SQLSetCursorName | アクティブ ステートメント ハンドル hstmt にカーソル名を関連付けます。 |
| SQLSetParam | ODBC 2.x の SQLBindParameter によって置き換えられています。 |
| SQLTransact | 接続に関連付けられているすべてのステートメント ハンドル (hstmts) でのすべてのアクティブな操作、または環境ハンドル (henv) に関連付けられているすべての接続に対して、コミットまたはロールバック操作を要求します。 手動モードのときにコミットが失敗した場合、トランザクションはアクティブなままになります。トランザクションのロールバックまたはコミット操作の再試行を選択できます。 自動トランザクション モードのときにコミット操作が失敗した場合、トランザクションは自動的にロールバックされます。トランザクションを非アクティブにすることはできません。 |