ISSAsynchStatus::Abort (OLE DB)
Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
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.