Marshal.FinalReleaseComObject(Object) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Runtime.InteropServices

Bütünleştirilmiş Kod:: System.Runtime.InteropServices.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Kaynak:: Marshal.NoCom.cs

Kaynak:: Marshal.NoCom.cs

Kaynak:: Marshal.NoCom.cs

Ö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) yapılan 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

Int32

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: SecurityCriticalAttribute SupportedOSPlatformAttribute

Özel durumlar

ArgumentException

o geçerli bir COM nesnesi değil.

ArgumentNullException

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 ReleaseComObject kadar bir döngüde yöntemini çağırmaya 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