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

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

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.

EXECUTE
    @hr = sp_OADestroy
    @object;

IF @hr <> 0
BEGIN
    EXECUTE sp_OAGetErrorInfo @object;
    RETURN;
END

Conteúdo relacionado

  • Last updated on