sp_OAGetErrorInfo (Transact-SQL)

  • Artikel

Gilt für: SQL Server

Ruft OLE-Automatisierungsfehlerinformationen ab.

Transact-SQL-Syntaxkonventionen

Syntax

sp_OAGetErrorInfo [ objecttoken ]
    [ , source OUTPUT ]
    [ , description OUTPUT ]
    [ , helpfile OUTPUT ]
    [ , helpid OUTPUT ]
[ ; ]

Argumente

objecttoken

Entweder das Objekttoken eines OLE-Objekts, das zuvor mithilfe sp_OACreatevon , oder NULL. Wenn objecttoken angegeben ist, werden Fehlerinformationen für dieses Objekt zurückgegeben. Wenn NULL angegeben, werden die Fehlerinformationen für den gesamten Batch zurückgegeben.

QuellAUSGABE

Die Quelle der Fehlerinformationen. Wenn angegeben, muss es sich um eine lokale Zeichen-, nchar-, Varchar- oder nvarchar-Variable sein. Der Rückgabewert wird bei Bedarf entsprechend der Länge der lokalen Variablen abgeschnitten.

description OUTPUT

Die Beschreibung des Fehlers. Wenn angegeben, muss es sich um eine lokale Zeichen-, nchar-, Varchar- oder nvarchar-Variable sein. Der Rückgabewert wird bei Bedarf entsprechend der Länge der lokalen Variablen abgeschnitten.

Helpfile OUTPUT

Die Hilfedatei für das OLE-Objekt. Wenn angegeben, muss es sich um eine lokale Zeichen-, nchar-, Varchar- oder nvarchar-Variable sein. Der Rückgabewert wird bei Bedarf entsprechend der Länge der lokalen Variablen abgeschnitten.

helpid OUTPUT

Die Kontext-ID der Hilfedatei. Wenn angegeben, muss es sich um eine lokale Int-Variable sein.

Hinweis

Die Parameter für diese gespeicherte Prozedur werden durch Position und nicht durch den Namen angegeben.

Rückgabecodewerte

0 (Erfolg) oder eine Nichtzeronummer (Fehler), die den ganzzahligen Wert des vom OLE-Automatisierungsobjekt zurückgegebenen HRESULT-Werts darstellt.

Weitere Informationen zu HRESULT-Rückgabecodes finden Sie unter OLE-Automatisierungsrücklaufcodes und Fehlerinformationen.

Resultset

Ist kein Ausgabeparameter angegeben, werden die Fehlerinformationen dem Client als Resultset zurückgegeben.

Spaltenname Datentyp Beschreibung
Error binary(4) Binärdarstellung der Fehlernummer
Source nvarchar(nn) Fehlerquelle
Description nvarchar(nn) Beschreibung des Fehlers
Helpfile nvarchar(nn) Hilfedatei für die Quelle
HelpID int Hilfekontext-ID in der Hilfequelldatei

Hinweise

Jeder Aufruf einer gespeicherten OLE-Automatisierungsprozedur (mit Ausnahme sp_OAGetErrorInfo) setzt die Fehlerinformationen zurück. Daher sp_OAGetErrorInfo werden Fehlerinformationen nur für den letzten aufruf der gespeicherten OLE-Automatisierungsprozeduren erhalten. Da sp_OAGetErrorInfo die Fehlerinformationen nicht zurückgesetzt werden, kann sie mehrmals aufgerufen werden, um dieselben Fehlerinformationen abzurufen.

In der folgenden Tabelle werden OLE-Automatisierungsfehler und deren übliche Ursachen aufgelistet.

Fehler und HRESULT Übliche Ursache
Ungültiger Variablentyp (0x80020008) Der Datentyp eines Als Methodenparameter übergebenen Transact-SQL-Werts entspricht nicht dem Microsoft Visual Basic-Datentyp des Methodenparameters, oder ein NULL Wert wurde als Methodenparameter übergeben.
Unbekannter Name (0x8002006) Der angegebene Eigenschafts- oder Methodenname wurde für das angegebene Objekt nicht gefunden.
Ungültige Klassenzeichenfolge (0x800401f3) Angegebene ProgID oder CLSID wird nicht als OLE-Objekt in einer SQL Server-Instanz registriert. Benutzerdefinierte OLE-Automatisierungsserver müssen registriert werden, bevor sie mithilfe sp_OACreatevon Instanziierung instanziiert werden können. Sie können Server mithilfe des Regsvr32.exe Hilfsprogramms für Prozessserver (.dll) oder den /REGSERVER Befehlszeilenschalter für lokale (.exe) Server registrieren.
Fehler bei der Serverausführung (0x80080005) Angegebenes OLE-Objekt wird als lokaler OLE-Server (.exe Datei) registriert, aber die .exe Datei konnte nicht gefunden oder gestartet werden.
Das angegebene Modul konnte nicht gefunden werden (0x8007007e) Angegebenes OLE-Objekt wird als IN-Process OLE-Server (.dll Datei) registriert, aber die .dll Datei konnte nicht gefunden oder geladen werden.
Typenkonflikt (0x80020005) Der Datentyp einer lokalen Transact-SQL-Variablen, die zum Speichern eines zurückgegebenen Eigenschaftswerts oder eines Methodenrückgabewerts verwendet wird, stimmt nicht mit dem Visual Basic-Datentyp der Eigenschafts- oder Methodenrückgabewert überein. Oder der Rückgabewert einer Eigenschaft oder einer Methode wurde angefordert, gibt jedoch keinen Wert zurück.
Der Datentyp oder der Wert des "context"-Parameters von sp_OACreate 'context' ist ungültig. (0x8004275B) Der Wert des Kontextparameters sollte 1, 4 oder 5 sein.

Weitere Informationen zum Verarbeiten von HRESULT-Rückgabecodes finden Sie unter OLE-Automatisierungsrücklaufcodes und Fehlerinformationen.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle "sysadmin ", oder führen Sie die Berechtigung direkt für diese gespeicherte Prozedur aus. Die Serverkonfigurationsoption "Ole Automation Procedures " muss aktiviert sein, um alle Systemprozeduren im Zusammenhang mit der OLE-Automatisierung zu verwenden.

Beispiele

Im folgenden Beispiel werden OLE-Automatisierungsfehlerinformationen angezeigt.

DECLARE @output VARCHAR(255);
DECLARE @hr INT;
DECLARE @source VARCHAR(255);
DECLARE @description VARCHAR(255);

PRINT 'OLE Automation Error Information';

EXEC @hr = sp_OAGetErrorInfo @object,
    @source OUTPUT,
    @description OUTPUT;

IF @hr = 0
BEGIN
    SELECT @output = '  Source: ' + @source;
    PRINT @output;
    SELECT @output = '  Description: ' + @description;
    PRINT @output;
END
ELSE
BEGIN
    PRINT '  sp_OAGetErrorInfo failed.'

    RETURN
END;

Zugehöriger Inhalt