Codes de retour
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’un SQL Server Native Client fonction membre du fournisseur OLE DB 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, les macros OLE/COM HRESULT-unpacking FAILED et IS_ERROR peuvent déterminer la réussite ou l’échec global d’une fonction.
Si FAILED ou IS_ERROR retourne TRUE, le consommateur SQL Server Native Client fournisseur OLE DB est assuré que l’exécution de la fonction membre a échoué. Lorsque FAILED ou IS_ERROR retourne FALSE et que le HRESULT n’est pas égal à S_OK, le consommateur SQL Server Native Client fournisseur OLE DB 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 des informations » à partir des interfaces d’erreur SQL Server Native Client fournisseur OLE DB. En outre, dans le cas où une fonction échoue clairement (la macro FAILED retourne TRUE), des informations d’erreur étendues sont disponibles à partir des interfaces d’erreur SQL Server Native Client fournisseur OLE DB.
SQL Server Native Client consommateurs du fournisseur OLE DB rencontrent généralement la DB_S_ERRORSOCCURRED retour HRESULT « 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 SQL Server Native Client membres du fournisseur OLE DB ne retournent pas le code de réussite S_FALSE. Toutes SQL Server Native Client fonctions membres du fournisseur OLE DB retournent toujours S_OK pour indiquer la réussite.