Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Kesesuaian
Versi Diperkenalkan: Kepatuhan Standar ODBC 3.0: ISO 92
Summary
SQLCloseCursor menutup kursor yang telah dibuka pada pernyataan dan membuang hasil yang tertunda.
Syntax
SQLRETURN SQLCloseCursor(
SQLHSTMT StatementHandle);
Arguments
StatementHandle
[Input] Handel pernyataan.
Returns
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.
Diagnostics
Ketika SQLCloseCursor mengembalikan SQL_ERROR atau SQL_SUCCESS_WITH_INFO, nilai SQLSTATE yang terkait dapat diperoleh dengan memanggil SQLGetDiagRec dengan HandleType SQL_HANDLE_STMT dan HandleStatementHandle. Tabel berikut mencantumkan nilai SQLSTATE yang umum dipulangkan oleh SQLCloseCursor dan menjelaskan masing-masing dalam konteks fungsi ini; notasi "(DM)" mendahului deskripsi SQLSTATE yang dikembalikan oleh Driver Manager. Kode pengembalian yang terkait dengan setiap nilai SQLSTATE SQL_ERROR, kecuali disebutkan sebaliknya.
| SQLSTATE | Kesalahan | Deskripsi |
|---|---|---|
| 01000 | Peringatan umum | Pesan informasi khusus driver. (Fungsi mengembalikan SQL_SUCCESS_WITH_INFO.) |
| 24000 | Status kursor tidak valid | Tidak ada kursor yang terbuka di StatementHandle. (Ini hanya dikembalikan oleh ODBC 3. x driver.) |
| HY000 | Kesalahan umum | Terjadi kesalahan yang tidak ada SQLSTATE tertentu dan tidak ada SQLSTATE khusus implementasi yang ditentukan. Pesan kesalahan yang dikembalikan oleh SQLGetDiagRec di buffer *MessageText menjelaskan kesalahan dan penyebabnya. |
| HY001 | Kesalahan alokasi memori | Driver tidak dapat mengalokasikan memori yang diperlukan untuk mendukung eksekusi atau penyelesaian fungsi. |
| HY010 | Kesalahan urutan fungsi | (DM) Fungsi eksekusi asinkron dipanggil untuk handle koneksi yang terkait dengan StatementHandle dan masih berjalan saat fungsi ini dipanggil. (DM) Fungsi eksekusi asinkron dipanggil untuk StatementHandle dan masih dijalankan ketika fungsi ini dipanggil. (DM) SQLExecute, SQLExecDirect, SQLBulkOperations, atau SQLSetPos dipanggil untuk StatementHandle dan dikembalikan SQL_NEED_DATA. Fungsi ini dipanggil sebelum data dikirim untuk semua parameter atau kolom data-at-execution. |
| HY013 | Kesalahan manajemen memori | Panggilan fungsi tidak dapat diproses karena objek memori yang mendasar tidak dapat diakses, mungkin karena kondisi memori yang rendah. |
| HY117 | Koneksi ditangguhkan karena status transaksi yang tidak diketahui. Hanya fungsi putuskan sambungan dan baca-saja yang diizinkan. | (DM) Untuk informasi selengkapnya tentang status ditangguhkan, lihat Fungsi SQLEndTran. |
| HYT01 | Waktu tunggu koneksi habis | Periode batas waktu koneksi kedaluwarsa sebelum sumber data merespons permintaan. Periode batas waktu koneksi diatur melalui SQLSetConnectAttr, SQL_ATTR_CONNECTION_TIMEOUT. |
| IM001 | Driver tidak mendukung fungsi ini | (DM) Driver yang terkait dengan StatementHandle tidak mendukung fungsi. |
Komentar
SQLCloseCursor mengembalikan SQLSTATE 24000 (Status kursor tidak valid) jika tidak ada kursor yang terbuka. Memanggil SQLCloseCursor setara dengan memanggil SQLFreeStmt dengan opsi SQL_CLOSE, kecuali SQLFreeStmt dengan SQL_CLOSE tidak berpengaruh pada aplikasi jika tidak ada kursor yang terbuka pada pernyataan, sedangkan SQLCloseCursor mengembalikan SQLSTATE 24000 (Status kursor tidak valid).
Note
Jika ODBC 3. x aplikasi yang bekerja dengan ODBC 2. x driver memanggil SQLCloseCursor ketika tidak ada kursor yang terbuka, SQLSTATE 24000 (Status kursor tidak valid) tidak dikembalikan, karena Driver Manager memetakan SQLCloseCursor ke SQLFreeStmt dengan SQL_CLOSE.
Untuk informasi lebih lanjut, lihat Menutup Kursor.
Contoh Kode
Lihat fungsi SQLBrowseConnect dan fungsi SQLConnect.
Fungsi Terkait
| Untuk informasi mengenai | Lihat |
|---|---|
| Membatalkan pemrosesan pernyataan | Fungsi SQLCancel |
| Membebaskan pegangan | Fungsi SQLFreeHandle |
| Memproses beberapa set hasil | Fungsi SQLMoreResults |