Udostępnij za pośrednictwem

sp_OADestroy (Transact-SQL)

  • Artykuł

Dotyczy:programu SQL Server

Niszczy utworzony obiekt OLE.

Transact-SQL konwencje składni

Składnia

sp_OADestroy objecttoken
[ ; ]

Argumenty

Ważny

Argumenty dla rozszerzonych procedur składowanych należy wprowadzić w określonej kolejności zgodnie z opisem w sekcji składni. Jeśli parametry są wprowadzane poza kolejnością, wystąpi komunikat o błędzie.

objecttoken

Token obiektu OLE, który został wcześniej utworzony przy użyciu sp_OACreate.

Zwracanie wartości kodu

0 (powodzenie) lub liczba niezerowa (niepowodzenie), która jest liczbą całkowitą HRESULT zwróconą przez obiekt automatyzacji OLE.

Aby uzyskać więcej informacji na temat kodów powrotnych HRESULT, zobacz kody powrotne automatyzacji OLE i informacje o błędach.

Uwagi

Jeśli sp_OADestroy nie zostanie wywołana, utworzony obiekt OLE zostanie automatycznie zniszczony na końcu partii.

Uprawnienia

Wymaga członkostwa w sysadmin stałej roli serwera lub wykonywania uprawnień bezpośrednio w tej procedurze składowanej. Aby można było używać dowolnej procedury systemowej powiązanej z automatyzacją OLE, należy włączyć opcję konfiguracji serwera Ole Automation.

Przykłady

Poniższy przykład niszczy utworzony wcześniej obiekt SQLServer.

EXEC @hr = sp_OADestroy @object;

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

    RETURN
END;

Powiązana zawartość