ISQLServerErrorInfo::GetErrorInfo (OLE DB)
Zwraca wskaźnik SQL Server macierzystego klienta dostawca OLE DB SSERRORINFO struktury zawierające SQL Server Szczegóły błędu.
Składnia
HRESULT GetErrorInfo(
SSERRORINFO**ppSSErrorInfo,
OLECHAR**ppErrorStrings);
Argumenty
ppSSErrorInfo[out]
Wskaźnik do struktury SSERRORINFO.Jeśli metoda nie działa lub nie ma żadnych SQL Server informacji związanych z błędem, dostawca nie przydzielał wszystkie pamięci i zapewnia, że ppSSErrorInfo argument jest pusty wskaźnik na wyjście.ppErrorStrings[out]
Wskaźnik do wskaźnika ciąg znaków Unicode.Jeśli metoda nie działa lub nie ma żadnych SQL Server informacji związanych z błędem, dostawca nie przydzielał wszystkie pamięci i zapewnia, że ppErrorStrings argument jest pusty wskaźnik na wyjście.Zwalnianie ppErrorStrings argumentu z IMalloc::Free metoda zwalnia trzech członków poszczególnych ciąg zwrócony struktury SSERRORINFO pamięć jest przydzielony w blok.
Wartości kodów powrotnych
S_OK
metoda powiodło się.E_INVALIDARG
Albo ppSSErrorInfo lub ppErrorStrings argument był NULL.BŁĄD E_OUTOFMEMORY
SQL Server Macierzystego klienta dostawca OLE DB nie może przydzielić wystarczającej ilości pamięci do zakończenia żądania.
Uwagi
SQL Server Macierzystego klienta dostawca OLE DB przydziela pamięć dla ciągów SSERRORINFO i OLECHAR zwrócone przez wskaźniki przekazanego przez konsumenta.Konsument musi cofnąć tej pamięci za pomocą IMalloc::Free metoda, gdy już wymaga dostępu do danych błędu.
Struktura SSERRORINFO się następująco:
typedef struct tagSSErrorInfo
{
LPOLESTR pwszMessage;
LPOLESTR pwszServer;
LPOLESTR pwszProcedure;
LONG lNative;
BYTE bState;
BYTE bClass;
WORD wLineNumber;
}
SSERRORINFO;
Element członkowski |
Opis |
|---|---|
pwszMessage |
Komunikat o błędzie z SQL Server.Wiadomość jest zwracana za pośrednictwem IErrorInfo::GetDescription metoda. |
pwszServer |
Nazwa wystąpienie SQL Server , w którym wystąpił błąd. |
pwszProcedure |
Nazwa procedura składowana, generowanie błędu w przypadku błędu w przechowywanej procedurze; w przeciwnym razie ciąg pusty. |
lNative |
SQL Server Numer błędu.Numer błędu są identyczne z zwracane w plNativeError parametr ISQLErrorInfo::GetSQLInfo metoda. |
bState |
Stan SQL Server błąd. |
bIdentyfikator klasy |
Ważności SQL Server błąd. |
wLineNumber |
Gdy ma to zastosowanie, w wierszu SQL Server procedura składowana , generowany jest komunikat o błędzie.Jeżeli procedura nie jest zaangażowane, wartością domyślną jest 1. |
Wskaźniki w strukturze odwoływać adresów w ciąg zwracany w ppErrorStrings argumentu.