ISSAsynchStatus::Abort (Penyedia OLE DB Klien Asli)

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Penting

SQL Server Native Client (sering disingkat SNAC) telah dihapus dari SQL Server 2022 (16.x) dan SQL Server Management Studio 19 (SSMS). Penyedia SQL Server Native Client OLE DB (SQLNCLI atau SQLNCLI11) dan Penyedia Microsoft OLE DB warisan untuk SQL Server (SQLOLEDB) tidak direkomendasikan untuk pengembangan baru. Beralih ke Microsoft OLE DB Driver (MSOLEDBSQL) baru untuk SQL Server ke depannya.

Membatalkan operasi yang dijalankan secara asinkron.

Sintaks

  
HRESULT Abort(  
        HCHAPTER hChapter,  
        DBASYNCHOP eOperation);  

Argumen

hChapter[in]
Handel bab untuk membatalkan operasi. Jika objek yang dipanggil bukan objek set baris atau operasi tidak berlaku untuk bab, pemanggil harus mengatur hChapter ke DB_NULL_HCHAPTER.

eOperation[in]
Operasi untuk membatalkan. Ini harus menjadi nilai berikut:

DBASYNCHOP_OPEN-Permintaan untuk membatalkan berlaku untuk pembukaan asinkron atau populasi set baris atau ke inisialisasi asinkron objek sumber data.

Mengembalikan Nilai Kode

S_OK
Permintaan untuk membatalkan operasi asinkron diproses. Ini tidak menjamin bahwa operasi itu sendiri dibatalkan. Untuk menentukan apakah operasi dibatalkan, konsumen harus memanggil ISSAsynchStatus::GetStatus dan memeriksa DB_E_CANCELED; namun, itu mungkin tidak dikembalikan dalam panggilan berikutnya.

DB_E_CANTCANCEL
Operasi asinkron tidak dapat dibatalkan.

DB_E_CANCELED
Permintaan untuk membatalkan operasi asinkron dibatalkan selama pemberitahuan. Operasi ini masih dijalankan secara asinkron.

E_FAIL
Terjadi kesalahan khusus penyedia.

E_INVALIDARG
Parameter hChapter tidak DB_NULL_HCHAPTER atau eOperation tidak DBASYNCH_OPEN.

E_UNEXPECTED
ISSAsynchStatus::Abort dipanggil pada objek sumber data tempat IDBInitialize::Initialize belum dipanggil, atau belum selesai.

ISSAsynchStatus::Abort dipanggil pada objek sumber data tempat IDBInitialize::Initialize dipanggil tetapi kemudian dibatalkan sebelum inisialisasi, atau telah kehabisan waktu. Objek sumber data masih belum diinisialisasi.

ISSAsynchStatus::Abort dipanggil pada set baris tempat ITransaction::Commit atau ITransaction::Abort sebelumnya dipanggil, dan set baris tidak bertahan dari penerapan atau membatalkan dan berada dalam keadaan zombie.

ISSAsynchStatus::Abort dipanggil pada set baris yang dibatalkan secara asinkron dalam fase inisialisasinya. Kumpulan baris berada dalam keadaan zombie.

Keterangan

Membatalkan inisialisasi kumpulan baris atau objek sumber data mungkin meninggalkan kumpulan baris atau objek sumber data dalam status zombie, sehingga semua metode selain metode IUnknown mengembalikan E_UNEXPECTED. Ketika ini terjadi, satu-satunya tindakan yang mungkin bagi konsumen adalah merilis kumpulan baris atau objek sumber data.

Memanggil ISSAsynchStatus::Membatalkan dan meneruskan nilai untuk eOperasi selain DBASYNCHOP_OPEN mengembalikan S_OK. Ini tidak menyiratkan bahwa operasi selesai atau dibatalkan.

Lihat Juga

Melakukan Operasi Asinkron