Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt einen Zeiger auf eine SQL Server Native Client OLE DB-Anbieter-SSERRORINFO-Struktur zurück, die die SQL Server-Fehlerdetails enthält.
Syntax
HRESULT GetErrorInfo(
SSERRORINFO**ppSSErrorInfo,
OLECHAR**ppErrorStrings);
Argumente
ppSSErrorInfo[out]
Ein Zeiger auf eine SSERRORINFO-Struktur. Wenn die Methode fehlschlägt oder keine SQL Server-Informationen mit dem Fehler verknüpft sind, weist der Anbieter keinen Arbeitsspeicher zu und stellt sicher, dass das PpSSErrorInfo-Argument ein Nullzeiger für die Ausgabe ist.
ppErrorStrings[out]
Ein Zeiger auf einen Unicode-Zeichenzeichenfolgenzeiger. Wenn die Methode fehlschlägt oder keine SQL Server-Informationen mit einem Fehler verknüpft sind, weist der Anbieter keinen Arbeitsspeicher zu und stellt sicher, dass das Argument ppErrorStrings ein Nullzeiger für die Ausgabe ist. Durch Freigeben des PpErrorStrings-Arguments mit der IMalloc::Free-Methode werden die drei einzelnen Zeichenfolgenmember der zurückgegebenen SSERRORINFO-Struktur freigegeben, da der Speicher in einem Block zugewiesen wird.
Rückgabecodewerte
S_OK
Die Methode war erfolgreich.
E_INVALIDARG
Entweder das PpSSErrorInfo - oder das PpErrorStrings-Argument war NULL.
E_OUTOFMEMORY
Der OLE DB-Anbieter von SQL Server Native Client konnte nicht genügend Arbeitsspeicher zuweisen, um die Anforderung abzuschließen.
Bemerkungen
Der OLE DB-Anbieter von SQL Server Native Client weist Speicher für die SSERRORINFO- und OLECHAR-Zeichenfolgen zu, die über die vom Consumer übergebenen Zeiger zurückgegeben werden. Der Verbraucher muss diesen Speicher mithilfe der IMalloc::Free-Methode verwalten, wenn er keinen Zugriff mehr auf die Fehlerdaten benötigt.
Die SSERRORINFO-Struktur ist wie folgt definiert:
typedef struct tagSSErrorInfo
{
LPOLESTR pwszMessage;
LPOLESTR pwszServer;
LPOLESTR pwszProcedure;
LONG lNative;
BYTE bState;
BYTE bClass;
WORD wLineNumber;
}
SSERRORINFO;
| Mitglied | BESCHREIBUNG |
|---|---|
| pwszMessage | Die Fehlermeldung von SQL Server. Die Nachricht wird über die IErrorInfo::GetDescription-Methode zurückgegeben. |
| pwszServer | Der Name der Instanz von SQL Server, auf der der Fehler aufgetreten ist. |
| pwszProcedure | Der Name der gespeicherten Prozedur, die den Fehler generiert, wenn der Fehler in einer gespeicherten Prozedur aufgetreten ist; andernfalls eine leere Zeichenfolge. |
| lNative | Die SQL Server-Fehlernummer. Die Fehlernummer ist identisch mit der, die im plNativeError-Parameter der ISQLErrorInfo::GetSQLInfo-Methode zurückgegeben wird. |
| bState | Der Status des SQL Server-Fehlers. |
| bClass | Der Schweregrad des SQL Server-Fehlers. |
| wLineNumber | Gegebenenfalls die Zeile einer gespeicherten SQL Server-Prozedur, die die Fehlermeldung generiert hat. Wenn keine Prozedur beteiligt ist, ist der Standardwert 1. |
Zeiger in den Strukturverweisadressen in der Zeichenfolge, die im Argument ppErrorStrings zurückgegeben wird.