Delen via


ISQLServerErrorInfo::GetErrorInfo (OLE DB)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Systeem (PDW)SQL-database in Microsoft Fabric

OLE DB-stuurprogramma downloaden

Geeft een pointer terug naar een OLE DB-driver voor SQL Server SSERRORINFO-structuur met de foutgegevens van SQL Server.

De OLE DB-driver voor SQL Server definieert de foutinterface ISQLServerErrorInfo . Deze interface geeft details terug van een SQL Server-fout, inclusief de ernst en status.

Syntaxis

  
HRESULT GetErrorInfo(  
   SSERRORINFO**ppSSErrorInfo,  
   OLECHAR**ppErrorStrings);  

Arguments

ppSSErrorInfo[uit]
Een verwijzing naar een SSERRORINFO-structuur. Als de methode faalt of er geen SQL Server-informatie aan de fout is gekoppeld, wijst de provider geen geheugen toe en zorgt ervoor dat het ppSSErrorInfo-argument een nullpointer is op output.

ppErrorStrings[uit]
Een pointer naar een Unicode-tekenstringpointer. Als de methode faalt of er geen SQL Server-informatie is gekoppeld aan een fout, wijst de provider geen geheugen toe en zorgt ervoor dat het ppErrorStrings-argument een nullpointer is op output. Het vrijmaken van het ppErrorStrings-argument met de IMalloc::Free-methode maakt de drie individuele stringleden van de teruggegeven SSERRORINFO-structuur vrij, aangezien het geheugen in een blok wordt toegewezen.

Retourcodewaarden

S_OK
De methode slaagde.

E_INVALIDARG
Ofwel het ppSSErrorInfo of het ppErrorStrings-argument was NUL.

E_OUTOFMEMORY
De OLE DB-driver voor SQL Server kon niet voldoende geheugen toewijzen om het verzoek te voltooien.

Opmerkingen

De OLE DB-driver voor SQL Server wijst geheugen toe voor de SSERRORINFO- en OLECHAR-strings die via de pointers van de consument worden teruggegeven. De consument moet dit geheugen vrijplaatsen door de IMalloc::Free-methode te gebruiken wanneer hij geen toegang meer tot de foutgegevens nodig heeft.

De SSERRORINFO-structuur wordt als volgt gedefinieerd:

typedef struct tagSSErrorInfo  
   {  
   LPOLESTR pwszMessage;  
   LPOLESTR pwszServer;  
   LPOLESTR pwszProcedure;  
   LONG lNative;  
   BYTE bState;  
   BYTE bClass;  
   WORD wLineNumber;  
   }  
SSERRORINFO;  
Lid Description
pwszMessage De foutmelding van SQL Server. Het bericht wordt teruggestuurd via de IErrorInfo::GetDescription methode.
pwszServer De naam van de instantie van SQL Server waarop de fout optrad.
pwszProcedure De naam van de opgeslagen procedure die de fout genereert als de fout optrad in een opgeslagen procedure; anders een lege string.
Inheems Het foutnummer van de SQL Server. Het foutgetal is identiek aan dat van de plNativeError-parameter van de ISQLErrorInfo::GetSQLInfo-methode .
bState De status van de SQL Server-fout.
bClass De ernst van de SQL Server-fout.
wLineNumber Indien van toepassing, de regel van een SQL Server-opgeslagen procedure die het foutbericht genereerde. Als er geen procedure bij betrokken is, is de standaardwaarde 1.

Pointers in de structuurreferentieadressen in de string gaven terug in het ppErrorStrings-argument .

Zie ook

RAISERROR (Transact-SQL)