Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy:sql Server
Azure SQL Database
Azure SQL Managed Instance
Azure 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 .