Partager via

ISSAbort::Abort (OLE DB)

  • Article

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Télécharger le pilote OLE DB

Annule l'ensemble de lignes actuel plus toutes les commandes par lot associées à la commande actuelle.

L’interface ISSAbort, qui est exposée dans le pilote OLE DB pour SQL Server, fournit la méthode ISSAbort::Abort utilisée pour annuler l’ensemble de lignes actuel, plus les commandes regroupées par lot avec la commande ayant généré initialement l’ensemble de lignes et dont l’exécution n’est pas encore achevée.

ISSAbort est une interface propre au pilote OLE DB pour SQL Server disponible en utilisant QueryInterface sur l’objet IMultipleResults retourné par ICommand::Execute ou IOpenRowset::OpenRowset.

Syntaxe

  
HRESULT Abort(void);

Notes

Si la commande abandonnée se trouve dans une procédure stockée, l’exécution de la procédure stockée (et de toutes les procédures ayant appelé cette procédure) sera annulée, tout comme le lot de commandes contenant l’appel de procédure stockée. Si le serveur est occupé à transférer un jeu de résultats vers le client, cette opération sera arrêtée. Si le client ne souhaite pas consommer un jeu de résultats, l’appel de **ISSAbort::Abortbefore releasing the rowset will speed up the rowset release, but if there is an open transaction and XACT_ABORT is ON, the transaction will be rolled back whenISSAbort::Abort » est appelé

Une fois que ISSAbort::Abort a retourné S_OK, l’interface IMultipleResults associée entre dans un état inutilisable et retourne DB_E_CANCELED à tous les appels de méthode (sauf pour les méthodes définies par l’interface IUnknown) jusqu’à ce qu’elle soit libérée. Si une interface IRowset a été obtenue à partir de l'interface IMultipleResults avant un appel à Abort, elle adopte également un état inutilisable et retourne DB_E_CANCELED à tous les appels de méthode (sauf pour les méthodes définies par l'interface IUnknown et IRowset::ReleaseRows) jusqu'à ce qu'elle soit diffusée après l'appel en bonne et due forme de la méthode ISSAbort::Abort.

Notes

À compter de SQL Server 2005 (9.x), si l’état XACT_ABORT du serveur est défini sur ON, l’exécution de la méthode ISSAbort::Abort prend fin et restaure toutes les transactions implicites ou explicites actuelles lors de la connexion à SQL Server. Les versions antérieures de SQL Server n'abandonneront pas la transaction actuelle.

Arguments

Aucun.

Codet de retour

S_OK
La méthode ISSAbort::Abort retourne S_OK si le lot a été annulé ou bien DB_E_CANTCANCEL dans le cas inverse. Si le lot a déjà été annulé, DB_E_CANCELED est retourné.

DB_E_CANCELED
Le lot a déjà été annulé.

DB_E_CANTCANCEL
Le lot n'a pas été annulé.

E_FAIL
Une erreur spécifique au fournisseur s’est produite. Pour obtenir des informations détaillées, utilisez l’interface ISQLServerErrorInfo.

E_UNEXPECTED
L'appel à la méthode était inattendu. Par exemple, l'objet est dans un état zombie parce que la méthode ISSAbort::Abort a déjà été appelée.

E_OUTOFMEMORY
Erreur de mémoire insuffisante.