Bagikan melalui


ISSAsynchStatus::Abort (OLE DB)

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

Unduh driver OLE DB

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. Nilai berikut harus digunakan:

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, operasi tersebut 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 yang IDBInitialize::Initialize belum dipanggil, atau belum selesai.

ISSAsynchStatus::Abort dipanggil pada objek sumber data yang 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 pembatalakan 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 IUnknown metode mengembalikan E_UNEXPECTED. Ketika ini terjadi, satu-satunya tindakan yang mungkin bagi konsumen adalah merilis kumpulan baris atau objek sumber data.

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

Lihat Juga

Melakukan Operasi Asinkron