Compartilhar via


sp_OADestroy (Transact-SQL)

Aplica-se: SQL Server

Destrói um objeto OLE criado.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_OADestroy objecttoken
[ ; ]

Argumentos

ObjectToken

O token de objeto de um objeto OLE que foi criado anteriormente usando sp_OACreate.

Valores do código de retorno

0 (sucesso) ou um número diferente de zero (falha) que é o valor inteiro do HRESULT retornado pelo objeto de Automação OLE.

Para obter mais informações sobre códigos de retorno HRESULT, consulte Códigos de retorno de automação OLE e informações de erro.

Comentários

Se sp_OADestroy não for chamado, o objeto OLE criado será destruído automaticamente no final do lote.

Permissões

Requer associação na função de servidor fixa sysadmin ou permissão de execução diretamente nesse procedimento armazenado. A opção de configuração do servidor Ole Automation Procedures deve ser habilitada para usar qualquer procedimento do sistema relacionado ao OLE Automation.

Exemplos

O exemplo a seguir destrói o objeto criado SQLServer anteriormente.

EXEC @hr = sp_OADestroy @object;

IF @hr <> 0
BEGIN
    EXEC sp_OAGetErrorInfo @object;

    RETURN
END;