sp_OADestroy (Transact-SQL)

Aplica-se a:simSQL Server (todas as versões com suporte)

Destrói um objeto OLE criado.

Topic link iconConvenções de sintaxe do 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 da 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 neste Procedimento Armazenado. Ole Automation Procedures A configuração deve ser 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;  

Consulte Também

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