Marshal.FinalReleaseComObject(Object) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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.