Codes de retour (fournisseur OLE DB Native Client)

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

Au niveau le plus élémentaire, une fonction membre réussit ou échoue. À un niveau plus précis, une fonction peut réussir, mais son succès peut ne pas être ce que le développeur d'applications prévoyait.

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

Lorsqu’une fonction membre du fournisseur OLE DB SQL Server Native Client retourne S_OK, la fonction a réussi.

Lorsqu’une fonction membre du fournisseur OLE DB SQL Server Native Client ne retourne pas S_OK, la macro FAILED de déballage OLE/COM HRESULT et IS_ERROR peuvent déterminer la réussite globale ou l’échec d’une fonction.

Si FAILED ou IS_ERROR retourne TRUE, le consommateur du fournisseur OLE DB SQL Server Native Client est assuré que l’exécution de la fonction membre a échoué. En cas d’échec ou de IS_ERROR renvoyer FALSE et que HRESULT n’est pas égal à S_OK, le consommateur du fournisseur OLE DB SQL Server Native Client est assuré que la fonction a réussi dans un certain sens. Le consommateur peut récupérer des informations détaillées sur ce retour « réussite avec les informations » à partir des interfaces d’erreur du fournisseur OLE DB SQL Server Native Client. En outre, dans le cas où une fonction échoue clairement (la macro FAILED retourne TRUE), les informations d’erreur étendues sont disponibles à partir des interfaces d’erreur du fournisseur OLE DB SQL Server Native Client.

Les consommateurs du fournisseur OLE DB SQL Server Native Client rencontrent généralement le retour HRESULT DB_S_ERRORSOCCURRED « réussite avec les 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. Comme aucune information d'erreur ne peut être disponible au consommateur autre que celle retournée dans les paramètres état-valeur, les consommateurs doivent implémenter la logique d'application pour extraire les valeurs d'état lorsqu'elles sont disponibles.

Les fonctions membres du fournisseur OLE DB SQL Server Native Client ne retournent pas le code de réussite S_FALSE. Toutes les fonctions membres du fournisseur OLE DB SQL Server Native Client retournent toujours S_OK pour indiquer la réussite.

Voir aussi

Erreurs