Marshal.FinalReleaseComObject(Object) Yöntem

Tanım

Başvuru sayısını 0 olarak ayarlayarak Çalışma Zamanı Çağrılabilen Sarmalayıcı (RCW) 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

Parametreyle o ilişkili RCW'nin başvuru sayısının yeni değeri, yayın başarılı olursa 0 (sıfır) olur.

Öznitelikler

Özel durumlar

o geçerli bir COM nesnesi değil.

o, null'e eşittir.

Açıklamalar

yöntemi, FinalReleaseComObject yönetilen başvuruyu bir COM nesnesine yayınlar. 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 dışındadır. Ancak RCW hala mevcut olabilir ve çöp toplanmayı bekliyor olabilir.

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.