Поделиться через


sp_OADestroy (Transact-SQL)

Область применения: SQL Server

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

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

Синтаксис

sp_OADestroy objecttoken
[ ; ]

Аргументы

objecttoken

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

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

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

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

Замечания

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

Разрешения

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

Примеры

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

EXEC @hr = sp_OADestroy @object;

IF @hr <> 0
BEGIN
    EXEC sp_OAGetErrorInfo @object;

    RETURN
END;