コア レベルの 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 が含まれている場合は、識別子の各要素を次のように囲みます。 [マイ テーブル] を選択します。 '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 が含まれている場合は、識別子の各要素を次のように囲みます。 [マイ テーブル] から [マイ テーブル] を選択します。 仮パラメーターとして配列を含む結果セットを使用する方法については、「 ストアド プロシージャから配列パラメーターを返す」を参照してください。 |
| SQLRowCount | Oracle では、最後の行をフェッチするまで、結果セット内の行数を確認する方法が提供されていないため、-1 が返されます。 |
| SQLSetCursorName | カーソル名をアクティブなステートメント ハンドル hstmt に関連付けます。 |
| SQLSetParam | ODBC 2 の SQLBindParameter に置き換えられました。x。 |
| SQLTransact | 接続に関連付けられているすべてのステートメント ハンドル (hstmts) に対するすべてのアクティブな操作、または環境ハンドルに関連付けられているすべての接続 ( henv) に対して、コミットまたはロールバック操作を要求します。 手動モードでコミットが失敗した場合、トランザクションはアクティブなままになります。トランザクションのロールバックまたはコミット操作の再試行を選択できます。 自動トランザクション モードでコミット操作が失敗した場合、トランザクションは自動的にロールバックされます。トランザクションを非アクティブにすることはできません。 |