Rückgabecodes
Auf der grundlegendsten Ebene wird eine Elementfunktion entweder erfolgreich ausgeführt oder schlägt fehl. Auf einer genaueren Ebene kann eine Funktion erfolgreich ausgeführt werden, ohne dass das Ergebnis dem entspricht, was vom Anwendungsentwickler beabsichtigt war.
Weitere Informationen über OLE DB-Rückgabecodes finden Sie unter Return Codes (OLE DB).
Wenn eine Elementfunktion des SQL Server Native Client OLE DB-Anbieters S_OK zurückgibt, wurde die Funktion erfolgreich ausgeführt.
Wenn eine Elementfunktion des SQL Server Native Client OLE DB-Anbieters nicht S_OK zurückgibt, ist das Entpacken von OLE/COM HRESULT fehlgeschlagen, und IS_ERROR-Makros können den Erfolg oder das Fehlschlagen einer Funktion bestimmen.
Wenn FAILED oder IS_ERROR den Wert TRUE zurückgibt, erkennt der SQL Server Native Client OLE DB-Anbieter daran, dass die Ausführung der Elementfunktion fehlgeschlagen ist. Wenn FAILED oder IS_ERROR den Wert FALSE zurückgibt und HRESULT nicht S_OK entspricht, erkennt der SQL Server Native Client OLE DB-Anbieter daran, dass die Funktion zumindest teilweise erfolgreich war. Der Consumer kann detaillierte Informationen über diese Erfolgsrückgabe mit Informationen von den Fehlerschnittstellen des SQL Server Native Client OLE DB-Anbieters abrufen. Auch in Fällen, in denen eine Funktion vollständig fehlschlägt (das FAILED-Makro gibt TRUE zurück), sind Fehlerinformationen von den Fehlerschnittstellen des SQL Server Native Client OLE DB-Anbieters verfügbar.
Consumer des SQL Server Native Client OLE DB-Anbieters erhalten häufig die HRESULT-Erfolgsrückgabe mit Informationen DB_S_ERRORSOCCURRED. In der Regel definieren Memberfunktionen, die DB_S_ERRORSOCCURRED zurückgeben, einen oder mehrere Parameter, die Statuswerte an den Consumer übermitteln. Möglicherweise stehen dem Consumer nur die Fehlerinformationen zur Verfügung, die in Statuswertparametern zurückgegeben werden. Daher sollten Consumer Anwendungslogik implementieren, um Statuswerte abzurufen, wenn diese verfügbar sind.
Die Elementfunktionen des SQL Server Native Client OLE DB-Anbieters geben den Erfolgscode S_FALSE nicht zurück. Alle Elementfunktionen des SQL Server Native Client OLE DB-Anbieters geben stets S_OK zurück, um Erfolg anzuzeigen.