Rückgabecodes

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

OLE DB-Treiber herunterladen

Auf der grundlegenden Ebene wird eine Elementfunktion entweder erfolgreich ausgeführt, oder sie schlägt fehl. Eine erfolgreich ausgeführte Funktion ist vielleicht nicht das Ziel des Anwendungsentwicklers.

Weitere Informationen zu OLE DB-Rückgabecodes finden Sie unter Rückgabecodes (OLE DB).

Wenn eine Elementfunktion des OLE DB-Treibers für SQL Server S_OK zurückgibt, wurde die Funktion erfolgreich ausgeführt.

Wenn eine Elementfunktion des OLE DB-Treibers für SQL Server 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 OLE DB-Treiber für SQL Server, dass die Ausführung der Memberfunktion fehlgeschlagen ist. Wenn FAILED oder IS_ERROR den Wert FALSE zurückgibt und HRESULT nicht S_OK entspricht, erkennt der OLE DB-Treiber für SQL Server, dass die Funktion zumindest teilweise erfolgreich war. Der Consumer kann ausführliche Informationen über diese „Erfolgsrückgabe mit Informationen“ von den Fehlerschnittstellen des OLE DB-Treibers für SQL Server abrufen. Auch in Fällen, in denen eine Funktion vollständig fehlschlägt (und das FAILED-Makro den Wert TRUE zurückgibt), sind erweiterte Fehlerinformationen von den Fehlerschnittstellen des OLE DB-Treibers für SQL Server verfügbar.

Bei Consumern des OLE DB-Treibers für SQL Server tritt häufig die HRESULT-"Erfolgsrückgabe mit Informationen" DB_S_ERRORSOCCURRED auf. In der Regel definieren Elementfunktionen, 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 OLE DB-Treibers für SQL Server geben nicht den Erfolgscode S_FALSE zurück. Alle Elementfunktionen des OLE DB-Treibers für SQL Server geben immer S_OK zurück, um eine erfolgreiche Ausführung anzugeben.

Weitere Informationen

Fehler