ISSAbort::Abort (Yerel İstemci OLE DB Sağlayıcısı)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Önemli

SQL Server Native Client (genellikle kısaltılmış SNAC) SQL Server 2022 (16.x) ve SQL Server Management Studio 19'dan (SSMS) kaldırılmıştır. Hem SQL Server Yerel İstemci OLE DB sağlayıcısı (SQLNCLI veya SQLNCLI11) hem de SQL Server için eski Microsoft OLE DB Sağlayıcısı (SQLOLEDB) yeni geliştirme için önerilmez. İleride SQL Server için yeni Microsoft OLE DB Sürücüsüne (MSOLEDBSQL) geçin.

Geçerli satır kümesini ve geçerli komutla ilişkili toplu komutları iptal eder.

SQL Server Yerel İstemci OLE DB sağlayıcısında kullanıma sunulan ISSAbort arabirimi, geçerli satır kümesini iptal etmek için kullanılan ISSAbort::Abort yöntemini ve başlangıçta satır kümesini oluşturan ve henüz yürütmeyi tamamlamamış komutuyla toplu olarak çalıştırılan komutları sağlar.

ISSAbort, ICommand::Execute veya IOpenRowset::OpenRowset tarafından döndürülen IMultipleResults nesnesinde QueryInterface kullanılarak kullanılabilen SQL Server Yerel İstemci sağlayıcısına özgü bir arabirimdir.

Sözdizimi

  
HRESULT Abort(void);  

Açıklamalar

Durdurulan komut bir saklı yordamdaysa saklı yordamın (ve bu yordamı çağıran tüm yordamların) yürütülmesi ve saklı yordam çağrısını içeren komut toplu işlemi sonlandırılır. Sunucu bir sonuç kümesini istemciye aktarma sürecindeyse, bu durdurulur. İstemci bir sonuç kümesi kullanmak istemiyorsa, satır kümesini serbest bırakmadan önce ISSAbort::Abort çağrısı satır kümesi sürümünü hızlandırır, ancak açık bir işlem varsa ve XACT_ABORT AÇIKsa, ISSAbort::Abort çağrıldığında işlem geri alınır

ISSAbort::Abort S_OK döndürdüğünde, ilişkili IMultipleResults arabirimi kullanılamaz duruma girer ve DB_E_CANCELED tüm yöntem çağrılarına (IUnknown arabirimi tarafından tanımlanan yöntemler dışında) serbest bırakılana kadar döndürür. Bir IRowset, Abort çağrısından önce IMultipleResults'tan alındıysa, ayrıca kullanılamaz bir durum girer ve tüm yöntem çağrılarına (IUnknown arabirimi ve IRowset::ReleaseRows tarafından tanımlanan yöntemler dışında) issAbort::Abort başarılı bir çağrıdan sonra serbest bırakılana kadar DB_E_CANCELED döndürür.

Uyarı

SQL Server 2005(9.x) sürümünden başlayarak, sunucu XACT_ABORT durumu AÇIKsa, ISSAbort::Abort yürütülürse SQL Server'a bağlanıldığında geçerli örtük veya açık işlemler sonlandırılır ve geri alınır. SQL Server'ın önceki sürümleri geçerli işlemi durdurmaz.

Arguments

Yok.

Dönüş Kodu Değerleri

S_OK
ISSAbort::Abort yöntemi, toplu iş iptal edildiyse S_OK döndürür ve aksi takdirde DB_E_CANTCANCEL. Toplu iş zaten iptal edilmişse DB_E_CANCELED döndürülür.

DB_E_CANCELED
Toplu iş zaten iptal edildi.

DB_E_CANTCANCEL
Toplu işlem iptal edilemedi.

E_FAIL
Sağlayıcıya özgü bir hata oluştu; ayrıntılı bilgi için ISQLServerErrorInfo arabirimini kullanın.

E_UNEXPECTED
yöntemine yapılan çağrı beklenmeyen bir durumdu. Örneğin, ISSAbort::Abort zaten çağrıldığından nesne zombi durumundadır.

E_OUTOFMEMORY
Bellek yetersiz hatası.

İlgili içerik

• ISSAsynchStatus::Abort (Yerel İstemci OLE DB Sağlayıcısı)