Rückgabecodes (Systemeigener Client OLE DB-Anbieter)

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)

Auf der grundlegenden Ebene wird eine Elementfunktion entweder erfolgreich ausgeführt, oder sie 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 zu OLE DB-Rückgabecodes finden Sie unter Rückgabecodes (OLE DB).

Wenn eine SQL Server Native Client OLE DB-Anbieterelementfunktion S_OK zurückgibt, war die Funktion erfolgreich.

Wenn eine SQL Server Native Client OLE DB-Anbieterelementfunktion nicht S_OK zurückgibt, kann das OLE/COM HRESULT-Entpacken fehlgeschlagen und IS_ERROR Makros den Gesamterfolg oder Fehler einer Funktion bestimmen.

Wenn FEHLER oder IS_ERROR TRUE zurückgibt, wird der OLE DB-Anbieter-Consumer des SQL Server Native Client-OLE DB-Anbieters sichergestellt, dass die Ausführung der Memberfunktion fehlgeschlagen ist. Wenn FAILED oder IS_ERROR FALSE zurückgeben und das HRESULT nicht gleich S_OK ist, ist der SQL Server Native Client OLE DB-Anbieter-Consumer sicher, dass die Funktion in irgendeinem Sinn erfolgreich war. Der Consumer kann detaillierte Informationen zu diesem "Erfolg mit Informationen" abrufen, die von den FEHLERschnittstellen des SQL Server Native Client OLE DB-Anbieters zurückgegeben werden. Falls eine Funktion eindeutig fehlschlägt (das FAILED-Makro gibt WAHR zurück), stehen erweiterte Fehlerinformationen über die FEHLERschnittstellen des SQL Server Native Client OLE DB-Anbieters zur Verfügung.

Sql Server Native Client OLE DB-Anbieter-Verbraucher treffen häufig auf die DB_S_ERRORSOCCURRED "Erfolg mit Informationen" HRESULT-Rückgabe. 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 SQL Server Native Client OLE DB-Anbietermitgliedsfunktionen geben den Erfolgscode nicht S_FALSE zurück. Alle SQL Server Native Client OLE DB-Anbieterfunktionen geben immer S_OK zurück, um den Erfolg anzuzeigen.

Weitere Informationen

Fehler