Marshal.FinalReleaseComObject(Object) Yöntem

Tanım

Başvuru sayısını 0 olarak ayarlayarak bir Çalışma Zamanı Çağrılabilen Sarmalayıcıya (RCW) yönelik tüm başvuruları serbest bırakır.

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 -> int
static member FinalReleaseComObject : obj -> int
Public Shared Function FinalReleaseComObject (o As Object) As Integer

Parametreler

o
Object

Yayınlanacak RCW.

Döndürülenler

Sürüm başarılı olursa parametresiyle o ilişkili RCW'nin başvuru sayısının yeni değeri 0 (sıfır) olur.

Öznitelikler

Özel durumlar

o geçerli bir COM nesnesi değil.

o, null değeridir.

Açıklamalar

yöntemi, FinalReleaseComObject yönetilen başvuruyu bir COM nesnesine serbest bırakır. Bu yöntemi çağırmak, 0 (sıfır) döndürene kadar bir döngüde yöntemini çağırmaya ReleaseComObject eşdeğerdir.

COM nesnesinde başvuru sayısı 0 olduğunda, COM nesnesi genellikle serbesttir, ancak bu COM nesnesinin uygulamasına bağlıdır ve çalışma zamanının denetiminin ötesindedir. Ancak, RCW hala var olabilir ve çöp toplamayı bekler.

COM nesnesi, temel alınan RCW'sinden ayrıldıktan sonra kullanılamaz. Başvuru sayısı 0 olduktan sonra RCW'de bir yöntemi çağırmaya çalışırsanız, bir InvalidComObjectException oluşturulur.

Şunlara uygulanır

Ayrıca bkz.