Marshal.FinalReleaseComObject(Object) 方法

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

來源:

Marshal.NoCom.cs

將執行階段可呼叫包裝函式 (RCW) 的參考計數設為 0，以釋放所有對 RCW 的參考。

public:
 static int FinalReleaseComObject(System::Object ^ o);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject (object o);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member FinalReleaseComObject : obj -> int

Public Shared Function FinalReleaseComObject (o As Object) As Integer

參數

o

Object

要釋放的 RCW。

傳回

Int32

與 o 參數建立關聯的 RCW 之參考計數的新值；如果釋放成功，則為 0 (零)。

屬性

SupportedOSPlatformAttribute

例外狀況

ArgumentException

o 不是有效的 COM 物件。

ArgumentNullException

o 為 null。

備註

方法 FinalReleaseComObject 會釋放 COM 物件的Managed參考。 呼叫這個方法相當於在迴圈中呼叫 ReleaseComObject 方法，直到傳回 0 (零) 為止。

當 COM 對象的參考計數變成 0 時，通常會釋放 COM 物件，但這取決於 COM 對象的實作，而且超出運行時間的控制。 不過，RCW 仍可存在，等候垃圾收集。

COM 物件在與基礎 RCW 分開之後，就無法使用它。 如果您在 RCW 的參考計數變成 0 之後嘗試呼叫 方法， InvalidComObjectException 將會擲回 。

另請參閱

• ReleaseComObject(Object)
• NullReferenceException