Bagikan melalui


sp_OADestroy (T-SQL)

Berlaku untuk:SQL Server

Menghancurkan objek OLE yang dibuat.

Konvensi sintaks transact-SQL

Sintaks

sp_OADestroy objecttoken
[ ; ]

Argumen

Penting

Argumen untuk prosedur tersimpan yang diperluas harus dimasukkan dalam urutan tertentu seperti yang dijelaskan di bagian Sintaks. Jika parameter dimasukkan di luar urutan, pesan kesalahan terjadi.

objecttoken

Token objek objek OLE yang sebelumnya dibuat dengan menggunakan sp_OACreate.

Mengembalikan nilai kode

0 (berhasil) atau angka bukan nol (kegagalan) yang merupakan nilai bilangan bulat HRESULT yang dikembalikan oleh objek OLE Automation.

Untuk informasi selengkapnya tentang kode pengembalian HRESULT, lihat kode pengembalian otomatisasi OLE dan informasi kesalahan.

Keterangan

Jika sp_OADestroy tidak dipanggil, objek OLE yang dibuat secara otomatis dihancurkan di akhir batch.

Izin

Memerlukan keanggotaan dalam peran server tetap sysadmin atau menjalankan izin langsung pada prosedur tersimpan ini. Opsi konfigurasi server Prosedur Ole Automation harus diaktifkan untuk menggunakan prosedur sistem apa pun yang terkait dengan OLE Automation.

Contoh

Contoh berikut menghancurkan objek yang dibuat SQLServer sebelumnya.

EXECUTE
    @hr = sp_OADestroy
    @object;

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