Návratové kódy

Platí na:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformový systém (PDW)SQL databáze v Microsoft Fabric

Stáhnout ovladač OLE DB

Na základní úrovni členská funkce buď uspěje, nebo selže. Když však funkce uspěje, její úspěch nemusí být tak, jak si vývojář aplikace zamýšlel.

Pro více informací o návratových kódech OLE DB viz Return Codes (OLE DB).

Když funkce člena OLE DB Driver for SQL Server vrátí S_OK, funkce byla úspěšná.

Když funkce člena OLE DB Driver for SQL Server nevrátí S_OK, OLE/COM HRESULT rozbalování selhalo a IS_ERROR makr může určit celkový úspěch nebo neúspěch funkce.

Pokud FAILED nebo IS_ERROR vrátí TRUE, uživatel OLE DB Driver for SQL Server má jistotu, že spuštění členské funkce selhalo. Když FAILED nebo IS_ERROR return FALSE a HRESULT se nerovná S_OK, uživatel OLE DB Driver for SQL Server má jistotu, že funkce v jistém smyslu uspěla. Spotřebitel může získat podrobné informace o tomto návratu "úspěch s informacemi" z OLE DB Driver pro rozhraní SQL Server pro chybové rozhraní. Také v případě, že funkce zjevně selže (makro FAILED vrátí TRUE), jsou rozšířené informace o chybách dostupné z ovladače OLE DB pro rozhraní SQL Server pro chybové rozhraní.

Uživatelé OLE DB Driver pro SQL Server běžně narazí na DB_S_ERRORSOCCURRED výsledek HRESULT "úspěch s informacemi". Typicky členské funkce, které se vracejí DB_S_ERRORSOCCURRED definují jeden nebo více parametrů, které doručují stavové hodnoty spotřebiteli. Spotřebitel nesmí mít k dispozici žádné chybové informace kromě těch, které se vracejí ve stavových parametrech, proto by měli implementovat aplikační logiku pro získávání stavových hodnot, jakmile jsou dostupné.

Funkce členů SQL Server Driver OLE DB nevracejí úspěšný kód S_FALSE. Všechny funkce členů OLE DB Driver for SQL Server vždy vracejí S_OK pro indikaci úspěchu.

Viz také

Chyby