Marshal.FinalReleaseComObject(Object) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Merilis semua referensi ke Runtime Callable Wrapper (RCW) dengan mengatur jumlah referensinya ke 0.
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
Parameter
- o
- Object
RCW yang akan dirilis.
Mengembalikan
Nilai baru jumlah referensi RCW yang terkait dengan o
parameter , yaitu 0 (nol) jika rilis berhasil.
- Atribut
Pengecualian
o
bukan objek COM yang valid.
o
adalah null
.
Keterangan
Metode FinalReleaseComObject ini merilis referensi terkelola ke objek COM. Memanggil metode ini setara dengan memanggil ReleaseComObject metode dalam perulangan hingga mengembalikan 0 (nol).
Ketika jumlah referensi pada objek COM menjadi 0, objek COM biasanya dikosongkan, meskipun ini tergantung pada implementasi objek COM dan berada di luar kendali runtime. Namun, RCW masih bisa ada, menunggu untuk dikumpulkan sampah.
Objek COM tidak dapat digunakan setelah dipisahkan dari RCW yang mendasar. Jika Anda mencoba memanggil metode pada RCW setelah jumlah referensinya menjadi 0, InvalidComObjectException akan dilemparkan.
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk