sp_OADestroy (Transact-SQL)

  • Artigo

Aplica-se a: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 (êxito) 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 à função de servidor fixa sysadmin ou permissão de execução diretamente neste Procedimento Armazenado. Ole Automation Procedures a configuração deve estar habilitada para usar qualquer procedimento do sistema relacionado à automação OLE.

Exemplos

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

EXEC @hr = sp_OADestroy @object;  
IF @hr <> 0  
BEGIN  
   EXEC sp_OAGetErrorInfo @object  
    RETURN  
END;

Confira também

Procedimentos armazenados de automação OLE (Transact-SQL)
Script de exemplo de automação