sp_OADestroy (Transact-SQL)

Применимо к:SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

  
sp_OADestroy objecttoken      

Аргументы

objecttoken
Является маркером объекта OLE, созданного ранее с помощью sp_OACreate.

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

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

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

Замечания

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

Разрешения

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

Примеры

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

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

См. также

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