Udostępnij przez


Kody powrotne

Dotyczy do:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSystem Platform Analitycznych (PDW)Baza danych SQL w Microsoft Fabric

pobierz sterownik OLE DB

Na podstawowym poziomie funkcja członkowska albo odnosi sukces, albo nie. Jednak gdy dana funkcja odnosi sukces, jej sukces może nie być taki, jakiego zamierzał twórca aplikacji.

Więcej informacji o kodach zwrotnych OLE DB można znaleźć w sekcji Return Codes (OLE DB).

Gdy funkcja członkowska OLE DB Driver for SQL Server zwraca S_OK, funkcja się powiodła.

Gdy funkcja członkowska OLE DB Driver for SQL Server nie zwraca S_OK, rozpakowywanie OLE/COM HRESULT zakończyło się niepowodzeniem, a makra IS_ERROR mogą określić ogólny sukces lub porażkę funkcji.

Jeśli FAILED lub IS_ERROR zgłosi TRUE, użytkownik OLE DB Driver for SQL Server ma pewność, że wykonanie funkcji członkowskich zakończyło się niepowodzeniem. Gdy FAILED lub IS_ERROR return FALSE i HRESULT nie jest równy S_OK, użytkownik OLE DB Driver for SQL Server ma pewność, że funkcja w pewnym sensie się powiodła. Konsument może pobrać szczegółowe informacje o tym powrocie "success with information" z interfejsów OLE DB Driver for SQL Server error. Ponadto, jeśli funkcja wyraźnie zawiodła (makro FAILED zwraca TRUE), rozszerzone informacje o błędach są dostępne w sterowniku OLE DB dla interfejsów SQL Server Driver.

Sterownik OLE DB dla konsumentów SQL Server często spotyka się z DB_S_ERRORSOCCURRED zwrotem HRESULT "success with information". Zazwyczaj funkcje członkowskie zwracające DB_S_ERRORSOCCURRED definiują jeden lub więcej parametrów dostarczających wartości statusowe konsumentowi. Konsument może nie mieć dostępu do informacji o błędzie poza tymi zwróconymi w parametrach status-value, dlatego konsumenci powinni zaimplementować logikę aplikacji, która pozwala pobierać wartości statusu, gdy są dostępne.

Sterownik OLE DB dla funkcji członków SQL Server nie zwraca kodu sukcesu S_FALSE. Wszystkie funkcje członkowskie OLE DB Driver for SQL Server zawsze zwracają S_OK, aby wskazać sukces.

Zobacz też

Błędy