Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Annule l’ensemble de lignes actuel ainsi que toutes les commandes par lots associées à la commande active.
Syntaxe
HRESULT Abort(void);
Remarques
Si la commande abandonnée se trouve dans une procédure stockée, l’exécution de la procédure stockée (et toutes les procédures qui avaient appelé cette procédure) sont arrêtées, ainsi que le lot de commandes qui contient l’appel de procédure stockée. Si le serveur est en cours de transfert d’un jeu de résultats vers le client, il est arrêté. Si le client ne souhaite pas consommer un jeu de résultats, l’appel de ISSAbort ::Abort avant de libérer l’ensemble de lignes accélère la mise en production de l’ensemble de lignes, mais s’il existe une transaction ouverte et XACT_ABORT est activé, la transaction est restaurée lorsque ISSAbort ::Abort est appelé
Après que ISSAbort ::Abort retourne S_OK, l’interface IMultipleResults associée entre dans un état inutilisable et retourne DB_E_CANCELED à tous les appels de méthode (à l’exception des méthodes définies par l’interface IUnknown ) jusqu’à ce qu’elle soit libérée. Si un IRowset avait été obtenu à partir d’IMultipleResults avant un appel à Abort, il entre également dans un état inutilisable et retourne DB_E_CANCELED à tous les appels de méthode (à l’exception des méthodes définies par l’interface IUnknown et IRowset ::ReleaseRows) jusqu’à ce qu’il soit libéré après un appel réussi à ISSAbort ::Abort.
Remarque
À compter de SQL Server 2005, si l’état du serveur XACT_ABORT est ACTIVÉ, l’exécution d’ISSAbort ::Abort se termine et annule toute transaction implicite ou explicite actuelle lorsqu’il est connecté à SQL Server. Les versions antérieures de SQL Server n’abandonnent pas la transaction actuelle.
Les arguments
Aucun.
Codet de retour
S_OK
La méthode ISSAbort ::Abort retourne S_OK si le lot a été annulé et DB_E_CANTCANCEL sinon. 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, car ISSAbort ::Abort a déjà été appelé.
E_OUTOFMEMORY
Erreur de mémoire insuffisante.