sp_OADestroy (Transact-SQL)

  • Статья
  • Чтение занимает 2 мин

Применимо к: даSQL Server (все поддерживаемые версии)

Удаляет созданный OLE-объект.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

  
sp_OADestroy objecttoken

Аргументы

обжекттокен
Токен объекта OLE, который был создан ранее с помощью sp_OACreate.

Значения кода возврата

0 (успешное завершение) или ненулевое число (неуспешное завершение), которое является целочисленным значением типа HRESULT, возвращаемого объектом OLE-автоматизации.

Дополнительные сведения о кодах возврата HRESULT см. в разделе коды возврата OLE Automation и сведения об ошибке.

Комментарии

Если sp_OADestroy не вызывается, созданный OLE-объект автоматически уничтожается в конце пакета.

Разрешения

Требуется членство в предопределенной роли сервера sysadmin или разрешение EXECUTE непосредственно в этой хранимой процедуре. Ole Automation Procedures для использования любой системной процедуры, связанной с OLE Automation, необходимо включить конфигурацию.

Примеры

В следующем примере удаляется ранее созданный объект SQLServer .

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

См. также:

хранимые процедуры OLE-автоматизации (на языке SQL)
Пример скрипта OLE-автоматизации