Codici restituiti

Al livello più elementare, una funzione membro può avere esito positivo o negativo. A un livello più approfondito, una funzione può avere esito positivo, ma tale esito potrebbe non corrispondere alle previsioni dello sviluppatore dell'applicazione.

Per ulteriori informazioni sui codici restituiti OLE DB, vedere Return Codes (OLE DB).

Quando una funzione membro del provider OLE DB di SQL Server Native Client restituisce S_OK, la funzione ha esito positivo.

Quando una funzione membro del provider OLE DB di SQL Server Native Client non restituisce S_OK, le macro FAILED e IS_ERROR che decomprimono OLE/COM HRESULT possono determinare l'esito positivo o negativo complessivo di una funzione.

Se FAILED o IS_ERROR restituisce TRUE, il consumer del provider OLE DB di SQL Server Native Client ha la conferma dell'esito negatio dell'esecuzione della funzione membro. Se FAILED o IS_ERROR restituise FALSE e il valore HRESULT è diverso da S_OK, il consumer del provider OLE DB di SQL Server Native Client ha la conferma dell'esito positivo della funzione. Il consumer può recuperare informazioni dettagliate su questa restituzione di "esito positivo con informazioni" dalle interfacce di errore del provider OLE DB di SQL Server Native Client. Inoltre, se una funzione ha un esito chiaramente negativo (la macro FAILED restituisce TRUE), le informazioni dettagliate sull'errore sono disponibili dalle interfacce di errore del provider OLE DB di SQL Server Native Client.

I consumer del provider OLE DB di SQL Server Native Client in genere ricevono il valore HRESULT "esito positivo con informazioni" di DB_S_ERRORSOCCURRED. Le funzioni membro che restituiscono DB_S_ERRORSOCCURRED definiscono in genere uno o più parametri che forniscono al consumer i valori di stato. Poiché è possibile che le uniche informazioni a disposizione del consumer siano quelle restituite nei parametri dei valori di stato, è necessario implementare la logica dell'applicazione per il recupero dei valori di stato quando essi sono disponibili.

Le funzioni membro del provider OLE DB di SQL Server Native Client non restituiscono il codice di esito positivo S_FALSE. Tutte le funzioni membro del provider OLE DB di SQL Server Native Client restituiscono sempre S_OK per indicare l'esito positivo.