ISSAbort::Abort(Native Client OLE DB Provider)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

Important

SQL Server Native Client(약칭 SNAC)는 SQL Server 2022(16.x) 및 SSMS(SQL Server Management Studio) 19에서 제거되었습니다. SQL Server Native Client OLE DB 공급자(SQLNCLI 또는 SQLNCLI11)와 레거시 Microsoft OLE DB Provider for SQL Server(SQLOLEDB)는 모두 새로운 개발에 권장되지 않습니다. 앞으로 SQL Server용 새 Microsoft OLE DB 드라이버(MSOLEDBSQL)로 전환합니다.

현재 행 집합과 현재 명령과 연결된 일괄 처리된 명령을 취소합니다.

SQL Server Native Client OLE DB 공급자에 노출되는 ISSAbort 인터페이스는 현재 행 집합을 취소하는 데 사용되는 ISSAbort::Abort 메서드와 행 집합을 처음 생성하고 아직 실행을 완료하지 않은 명령으로 일괄 처리된 모든 명령을 제공합니다.

ISSAbort는 ICommand::Execute 또는 IOpenRowset::OpenRowset에서 반환된 IMultipleResults 개체에서 QueryInterface를 사용하여 사용할 수 있는 SQL Server Native Client 공급자별 인터페이스입니다.

구문

  
HRESULT Abort(void);  

설명

중단되는 명령이 저장 프로시저에 있는 경우 저장 프로시저(및 해당 프로시저를 호출한 모든 프로시저)의 실행은 종료되고 저장 프로시저 호출이 포함된 명령 일괄 처리도 종료됩니다. 서버에서 결과 집합을 클라이언트로 전송 중이면 전송이 중지됩니다. 클라이언트가 결과 집합을 사용하지 않으려는 경우 행 집합을 해제하기 전에 ISSAbort::Abort를 호출하면 행 집합 릴리스 속도가 빨라지지만 열려 있는 트랜잭션이 있고 XACT_ABORT ON이면 ISSAbort::Abort가 호출될 때 트랜잭션이 롤백됩니다.

ISSAbort::Abort가 S_OK 반환한 연결된 IMultipleResults 인터페이스는 사용할 수 없는 상태로 전환되고 해제될 때까지 모든 메서드 호출(IUnknown 인터페이스에서 정의한 메서드 제외)에 DB_E_CANCELED 반환합니다. IRowset을 IMultipleResults에서 가져온 경우 Abort 호출 전에 사용할 수 없는 상태가 되며 ISSAbort::Abort에 대한 성공적인 호출 후에 해제될 때까지 모든 메서드 호출(IUnknown 인터페이스 및 IRowset::ReleaseRows에서 정의한 메서드 제외)에 DB_E_CANCELED 반환합니다.

참고 항목

SQL Server 2005(9.x)부터 서버 XACT_ABORT 상태가 ON인 경우 ISSAbort::Abort실행하면 SQL Server에 연결될 때 현재 암시적 또는 명시적 트랜잭션이 종료되고 롤백됩니다. 이전 버전의 SQL Server는 현재 트랜잭션을 중단하지 않습니다.

인수

없음

반환 코드 값

S_OK
일괄 처리가 취소되었으면 ISSAbort::Abort 메서드가 S_OK를 반환하고, 그렇지 않으면 DB_E_CANTCANCEL을 반환합니다. 일괄 처리가 이미 취소된 경우 DB_E_CANCELED 반환됩니다.

DB_E_CANCELED
일괄 처리가 이미 취소되었습니다.

DB_E_CANTCANCEL
일괄 처리가 취소되지 않았습니다.

E_FAIL
공급자 관련 오류가 발생했습니다. 자세한 내용을 보려면 ISQLServerErrorInfo 인터페이스를 사용하세요.

E_UNEXPECTED
예기치 않은 메서드가 호출되었습니다. ISSAbort::Abort가 이미 호출되어 개체가 좀비 상태에 있는 경우를 예로 들 수 있습니다.

E_OUTOFMEMORY
메모리 부족 오류입니다.

참고 항목

ISSAbort(OLE DB)