Partager via

Codes de retour

  • 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

À un niveau élémentaire, une fonction membre réussit ou échoue. Toutefois, lorsqu’une fonction réussit, sa réussite peut ne pas être celle prévue par le développeur de l’application.

Pour plus d’informations sur les codes de retour OLE DB, consultez Codes de retour (OLE DB).

Lorsqu'une fonction membre OLE DB Driver pour SQL Server retourne S_OK, la fonction a réussi.

Quand une fonction membre du pilote OLE DB pour SQL Server ne retourne pas S_OK, les macros OLE/COM FAILED et IS_ERROR de décompactage de HRESULT peuvent déterminer le succès ou l’échec global d’une fonction.

Si FAILED ou IS_ERROR retourne la valeur TRUE, le consommateur du pilote OLE DB pour SQL Server a l’information selon laquelle l’exécution de la fonction membre a échoué. Si FAILED ou IS_ERROR retourne FALSE et que HRESULT n'est pas égal à S_OK, le consommateur OLE DB Driver pour SQL Server est assuré que la fonction a réussi d'une façon ou d'une autre. Le consommateur peut extraire des informations détaillées sur ce retour « réussite avec informations » à partir des interfaces d’erreur du pilote OLE DB pour SQL Server. De même, dans le cas où une fonction échoue clairement (la macro FAILED retourne TRUE), les informations d’erreur étendues sont disponibles via les interfaces d’erreur du pilote OLE DB pour SQL Server.

Les consommateurs OLE DB Driver pour SQL Server rencontrent généralement le retour HRESULT de DB_S_ERRORSOCCURRED « réussi avec informations ». En général, les fonctions membres qui retournent DB_S_ERRORSOCCURRED définissent un ou plusieurs paramètres qui remettent les valeurs d'état au consommateur. Il est possible que le consommateur ne dispose d’aucune information d’erreur autre que celle retournée dans les paramètres état-valeur : les consommateurs doivent donc implémenter la logique d’application nécessaire pour extraire les valeurs d’état quand elles sont disponibles.

Les fonctions membres OLE DB Driver pour SQL Server ne retournent pas le code de réussite S_FALSE. Toutes les fonctions membres OLE DB Driver pour SQL Server retournent toujours S_OK pour indiquer le succès.

Voir aussi

Erreurs