Partilhar via


sp_OADestroy (Transact-SQL)

Aplica-se a:SQL Server

Destrói um objeto OLE criado.

Transact-SQL convenções de sintaxe

Sintaxe

sp_OADestroy objecttoken
[ ; ]

Argumentos

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção de 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 de 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á automaticamente destruído no final do lote.

Permissões

Requer associação ao sysadmin função de servidor fixa ou permissão de execução diretamente neste procedimento armazenado. A opção Ole Automation Procedures configuração do servidor 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.

EXECUTE
    @hr = sp_OADestroy
    @object;

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