ISQLServerErrorInfo::GetErrorInfo (Native Client OLE DB Provider)

Dotyczy:sql ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Ważna

SQL Server Native Client (często skracany jako SNAC) został usunięty z SQL Server 2022 (16.x) i SQL Server Management Studio 19 (SSMS). Zarówno dostawca OLE DB klienta natywnego programu SQL Server (SQLNCLI lub SQLNCLI11), jak i starszy dostawca MICROSOFT OLE DB dla programu SQL Server (SQLOLEDB) nie są zalecane w przypadku nowego programowania. Przełącz się na nowy sterownik Microsoft OLE DB (MSOLEDBSQL) dla programu SQL Server na przyszłość.

Zwraca wskaźnik do struktury dostawcy natywnego klienta OLE DB dla dostawcy SQL Server, zawierającej szczegóły błędu SQL Server.

Provider natywnego klienta OLE DB SQL Server definiuje interfejs błędów ISQLServerErrorInfo. Ten interfejs zwraca szczegóły błędu SQL Servera, w tym jego nasilenie i stan.

Syntax

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

Arguments

ppSSErrorInfo[out]
Wskaźnik do struktury SSERRORINFO. Jeśli metoda zawiodła lub nie ma informacji SQL Server powiązanej z błędem, dostawca nie przydziela żadnej pamięci i zapewnia, że argument ppSSErrorInfo jest wskaźnikiem zerowym na wyjściu.

ppErrorStrings[out]
Wskaźnik do znaków Unicode. Jeśli metoda zawiodła lub nie ma informacji SQL Server powiązanych z błędem, dostawca nie przydziela żadnej pamięci i zapewnia, że argument ppErrorStrings jest wskaźnikiem null na wyjściu. Uwolnienie argumentu ppErrorStrings metodą IMalloc::Free uwalnia trzy indywidualne elementy struktury zwróconej SSERRORINFO, ponieważ pamięć jest alokowana w bloku.

Wartości kodów zwracanych

S_OK
Metoda się powiodła.

E_INVALIDARG
Albo argument ppSSErrorInfo , albo ppErrorStrings był NULL.

E_OUTOFMEMORY
Dostawca natywnego klienta OLE DB SQL Server nie był w stanie przydzielić wystarczającej ilości pamięci do wykonania żądania.

Remarks

Dostawca natywnej klientowej bazy danych OLE DB SQL Server przydziela pamięć na ciągi SSERRORINFO i OLECHAR zwracane przez wskaźniki przekazywane przez konsumenta. Konsument musi zlokalizować tę pamięć za pomocą metody IMalloc::Free , gdy nie wymaga ona już dostępu do danych błędów.

Struktura SSERRORINFO jest zdefiniowana następująco:

typedef struct tagSSErrorInfo  
   {  
   LPOLESTR pwszMessage;  
   LPOLESTR pwszServer;  
   LPOLESTR pwszProcedure;  
   LONG lNative;  
   BYTE bState;  
   BYTE bClass;  
   WORD wLineNumber;  
   }  
SSERRORINFO;  
Członek Description
pwszMessage Komunikat o błędzie z SQL Server. Wiadomość jest zwracana metodą IErrorInfo::GetDescription .
pwszServer Nazwa instancji SQL Server, na której wystąpił błąd.
pwszProcedure Nazwa procedury przechowywanej generującej błąd, jeśli błąd wystąpił w procedurze zapisanej; w przeciwnym razie jest to ciąg bez ograniczeń.
lNative Numer błędu SQL Server. Numer błędu jest identyczny z tym zwróconym w parametrze plNativeError metody ISQLErrorInfo::GetSQLInfo .
bState Stan błędu SQL Server.
bClass Skala błędu SQL Server.
wLineNumber Gdy dotyczy, linia procedury przechowywanej SQL Server, która generowała komunikat o błędzie. Jeśli nie ma procedury, wartość domyślna wynosi 1.

Wskaźniki w odniesieniu do struktury adresują w ciągu zwrotnym w argumentze ppErrorStrings .