sp_OAGetErrorInfo (Transact-SQL)

  • Article

S'applique à : SQL Server

Obtient des informations d'erreur OLE Automation.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

objecttoken

Jeton d’objet d’un objet OLE créé précédemment à l’aide sp_OACreatede , ou NULL. Si objecttoken est spécifié, les informations d’erreur de cet objet sont retournées. Si NULL elle est spécifiée, les informations d’erreur pour l’ensemble du lot sont retournées.

SORTIE source

Source des informations d’erreur. Si elle est spécifiée, il doit s’agir d’une variable char, nchar, varchar ou nvarchar locale. Si nécessaire, la valeur renvoyée est tronquée pour s'adapter à la variable locale.

description OUTPUT

Description de l'erreur. Si elle est spécifiée, il doit s’agir d’une variable char, nchar, varchar ou nvarchar locale. Si nécessaire, la valeur renvoyée est tronquée pour s'adapter à la variable locale.

helpfile OUTPUT

Fichier d’aide pour l’objet OLE. Si elle est spécifiée, il doit s’agir d’une variable char, nchar, varchar ou nvarchar locale. Si nécessaire, la valeur renvoyée est tronquée pour s'adapter à la variable locale.

HELPID OUTPUT

ID de contexte du fichier d’aide. S’il est spécifié, il doit s’agir d’une variable int locale.

Remarque

Les paramètres pour cette procédure stockée sont spécifiés par position et non pas par nom.

Valeurs des codes de retour

0 (réussite) ou nombre différent de zéro (échec) qui est la valeur entière du HRESULT retourné par l’objet OLE Automation.

Pour plus d’informations sur les codes de retour HRESULT, consultez les codes de retour OLE Automation et les informations d’erreur.

Jeu de résultats

Si aucun paramètre de sortie n'est spécifié, les informations d'erreur sont renvoyées au client sous la forme d'un ensemble de résultats.

Nom de la colonne Type de données Description
Error binary(4) Représentation binaire du numéro d'erreur.
Source nvarchar(nn) Source de l'erreur.
Description nvarchar(nn) Description de l’erreur.
Helpfile nvarchar(nn) Fichier d'aide pour la source.
HelpID int ID du contexte de l'aide dans le fichier source d'aide.

Notes

Chaque appel à une procédure stockée OLE Automation (sauf sp_OAGetErrorInfo) réinitialise les informations d’erreur ; par conséquent, sp_OAGetErrorInfo obtient uniquement les informations d’erreur pour l’appel de procédure stockée OLE Automation le plus récent. Étant donné que sp_OAGetErrorInfo ne réinitialise pas les informations d’erreur, elle peut être appelée plusieurs fois pour obtenir les mêmes informations d’erreur.

Le tableau suivant donne la liste des erreurs OLE Automation et leurs causes courantes.

Erreur et HRESULT Cause courante
Type de variable incorrecte (0x80020008) Le type de données d’une valeur Transact-SQL passée en tant que paramètre de méthode ne correspond pas au type de données Microsoft Visual Basic du paramètre de méthode, ou une NULL valeur a été passée en tant que paramètre de méthode.
Nom inconnu (0x8002006) La propriété ou le nom de méthode spécifié n’a pas été trouvé pour l’objet spécifié.
Chaîne de classe non valide (0x800401f3) ProgID ou CLSID spécifié n’est pas inscrit en tant qu’objet OLE sur une instance de SQL Server. Les serveurs OLE Automation personnalisés doivent être inscrits avant de pouvoir être instanciés à l’aide sp_OACreatede . Vous pouvez inscrire des serveurs à l’aide de l’utilitaire Regsvr32.exe pour les serveurs in-process (.dll) ou le /REGSERVER commutateur de ligne de commande pour les serveurs locaux (.exe).
Échec de l’exécution du serveur (0x80080005) L’objet OLE spécifié est inscrit en tant que serveur OLE local (.exe fichier), mais le fichier .exe est introuvable ou démarré.
Impossible de trouver le module spécifié (0x8007007e) L’objet OLE spécifié est inscrit en tant que serveur OLE in-process (.dll fichier), mais le fichier .dll est introuvable ou chargé.
Incompatibilité de type (0x80020005) Le type de données d’une variable locale Transact-SQL utilisée pour stocker une valeur de propriété retournée ou une valeur de retour de méthode ne correspond pas au type de données Visual Basic de la propriété ou de la valeur de retour de méthode. Ou bien, la valeur de retour d’une propriété ou d’une méthode a été demandée, mais elle ne retourne pas de valeur.
Le type de données ou la valeur du paramètre « context » n’est sp_OACreate pas valide. (0x8004275B) La valeur du paramètre de contexte doit être : 1, 4 ou 5.

Pour plus d’informations sur le traitement des codes de retour HRESULT, consultez les codes de retour OLE Automation et les informations d’erreur.

autorisations

Nécessite l’appartenance au rôle serveur fixe sysadmin ou l’autorisation d’exécution directement sur cette procédure stockée. L’option de configuration du serveur Procédures Ole Automation doit être activée pour utiliser n’importe quelle procédure système liée à OLE Automation.

Exemples

L'exemple suivant affiche des informations d'erreur OLE Automation.

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;

Contenu connexe