Marshal.FinalReleaseComObject(Object) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將執行階段可呼叫包裝函式 (RCW) 的參考計數設為 0，以釋放所有對 RCW 的參考。
public:
static int FinalReleaseComObject(System::Object ^ o);[System.Security.SecurityCritical]
public static int FinalReleaseComObject (object o);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject (object o);public static int FinalReleaseComObject (object o);[<System.Security.SecurityCritical>]
static member FinalReleaseComObject : obj -> int[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member FinalReleaseComObject : obj -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As Integer參數
- o
- Object
要釋放的 RCW。
傳回
與 o 參數建立關聯的 RCW 之參考計數的新值；如果釋放成功，則為 0 (零)。
- 屬性
例外狀況
o 不是有效的 COM 物件。
o 為 null。
備註
方法 FinalReleaseComObject 會釋放 COM 物件的 Managed 參考。 呼叫這個方法相當於在迴圈中呼叫 ReleaseComObject 方法，直到傳回 0 (零) 為止。
當 COM 物件的參考計數變成 0 時，通常會釋放 COM 物件，不過這取決於 COM 物件的實作，而且超出執行時間的控制。 不過，RCW 仍可存在，等待垃圾收集。
在 COM 物件與其基礎 RCW 分開之後，就無法使用它。 如果您嘗試在 RCW 的參考計數變成 0 之後呼叫 方法， InvalidComObjectException 將會擲回 。