Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 ü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 Consumer des SQL Server Native Client OLE DB-Anbieters daran, dass die Funktion zumindest teilweise erfolgreich war. Der Consumer kann ausführliche 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.
Bei Consumern des SQL Server Native Client OLE DB-Anbieters 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 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.