Compartilhar via


Informações sobre erros e códigos de retorno de automação OLE

Os procedimentos armazenados do sistema de automação OLE retornam um código de retorno int que é o HRESULT retornado pela operação de automação OLE subjacente. O HRESULT de 0 indica sucesso. HRESULT diferente de zero é um código de erro OLE em formato hexadecimal 0x800nnnnn, mas quando retornado com um valor int em um código de retorno de procedimento armazenado, o HRESULT tem o formato 214nnnnnnn.

Por exemplo, passar um nome de objeto inválido (SQLDMO.Xyzzy) para sp_OACreate faz o procedimento retornar um HRESULT de int de 2147221005, que é 0x800401f3 em número hexadecimal.

Você pode usar CONVERT(binary(4), @hresult) para converter um HRESULT de int em um valor binary. Entretanto, o uso de CONVERT(char(10), CONVERT(binary(4), @hresult)) resulta em uma cadeia ilegível porque cada byte de HRESULT é convertido em um único caractere ASCII. É possível usar o seguinte procedimento armazenado de amostra HexToChar para converter um HRESULT de int em um valor de char que contenha uma cadeia hexadecimal legível.

USE AdventureWorks2012;
GO
IF EXISTS(SELECT name FROM sys.objects
          WHERE name = N'dbo.sp_HexToChar')
    DROP PROCEDURE HexToChar;
GO
CREATE PROCEDURE dbo.sp_HexToChar
    @BinValue varbinary(255),
    @HexCharValue nvarchar(255) OUTPUT
AS
    DECLARE @CharValue nvarchar(255);
    DECLARE @Position int;
    DECLARE @Length int;
    DECLARE @HexString nchar(16);
    SELECT @CharValue = N'0x';
    SELECT @Position = 1;
    SELECT @Length = DATALENGTH(@BinValue);
    SELECT @HexString = N'0123456789ABCDEF';
    WHILE (@Position <= @Length)
    BEGIN
        DECLARE @TempInt int;
        DECLARE @FirstInt int;
        DECLARE @SecondInt int;
        SELECT @TempInt = CONVERT(int, SUBSTRING(@BinValue,@Position,1));
        SELECT @FirstInt = FLOOR(@TempInt/16);
        SELECT @SecondInt = @TempInt - (@FirstInt*16);
        SELECT @CharValue = @CharValue +
            SUBSTRING(@HexString, @FirstInt+1, 1) +
            SUBSTRING(@HexString, @SecondInt+1, 1);
        SELECT @Position = @Position + 1;
    END
    SELECT @HexCharValue = @CharValue;
GO
DECLARE @BinVariable varbinary(35);
DECLARE @CharValue nvarchar(35);

SET @BinVariable = 123456;

EXECUTE dbo.sp_HexToChar
    @binvalue = @BinVariable,
    @HexCharValue = @CharValue OUTPUT;

SELECT @BinVariable AS BinaryValue,
    @CharValue AS CharacterRep;
GO

Você pode usar o seguinte procedimento armazenado de amostra, sp_displayoaerrorinfo para exibir informações de erro de automação OLE quando um dos procedimentos de automação OLE retornar um código de retorno de HRESULT que não seja zero. O procedimento armazenado de amostra a seguir usa HexToChar.

CREATE PROCEDURE dbo.sp_DisplayOAErrorInfo
    @Object int,
    @HResult int
AS
    DECLARE @Output nvarchar(255);
    DECLARE @HRHex nchar(10);
    DECLARE @HR int;
    DECLARE @Source nvarchar(255);
    DECLARE @Description nvarchar(255);
    PRINT N'OLE Automation Error Information';
    EXEC HexToChar @HResult, @HRHex OUT;
    SELECT @Output = N'  HRESULT: ' + @HRHex;
    PRINT @Output;
    EXEC @HR = sp_OAGetErrorInfo
        @Object,
        @Source OUT,
        @Description OUT;
    IF @HR = 0
    BEGIN
        SELECT @Output = N'  Source: ' + @Source;
        PRINT @Output;
        SELECT @Output = N'  Description: '
               + @Description;
        PRINT @Output;
    END
    ELSE
    BEGIN
       PRINT N' sp_OAGetErrorInfo failed.';
       RETURN;
    END
GO

Conteúdo relacionado

sp_OAGetErrorInfo (Transact-SQL)