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) (en anglais).
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, 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 fournisseur OLE DB SQL Server Native Client est assuré que 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 du fournisseur OLE DB SQL Server Native Client est assuré que la fonction a réussi d'une façon ou d'une autre. Le consommateur peut récupérer des informations détaillées sur ce retour « réussi avec informations » à partir des interfaces d'erreur du fournisseur OLE DB SQL Server Native Client. De même, dans le cas où une fonction échoue clairement (la macro FAILED retourne TRUE), les informations d'erreur étendues sont disponibles au travers 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 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. 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 membre du fournisseur OLE DB SQL Server Native Client retournent toujours S_OK pour indiquer le succès.