ICorDebugProcess2::GetReferenceValueFromGCHandle Method

Mendapatkan penunjuk referensi ke objek terkelola yang ditentukan yang memiliki handel pengumpulan sampah.

Syntax

HRESULT GetReferenceValueFromGCHandle (
    [in]  UINT_PTR                 handle,
    [out] ICorDebugReferenceValue  **pOutValue
);

Parameter-parameternya

handle [di] Penunjuk ke objek terkelola yang memiliki handel pengumpulan sampah. Nilai ini adalah IntPtr objek dan dapat diambil dari untuk objek terkelola GCHandle .

pOutValue [out] Penunjuk ke alamat objek ICorDebugReferenceValue yang mewakili referensi ke objek terkelola yang ditentukan.

Komentar

Jangan bingung nilai referensi yang dikembalikan dengan nilai referensi pengumpulan sampah.

Referensi yang dikembalikan berulah seperti referensi normal. Ini dinonaktifkan ketika eksekusi kode berlanjut setelah titik henti. Masa pakai objek target tidak dipengaruhi oleh masa pakai nilai referensi.

Nota

Metode GetReferenceValueFromGCHandle tidak memvalidasi handel. Oleh karena itu, metode ini GetReferenceValueFromGCHandle berpotensi merusak debugger dan kode yang di-debug jika handel yang tidak valid diteruskan.

Persyaratan

Platform: Lihat Sistem operasi yang didukung .NET.

Header: CorDebug.idl, CorDebug.h

Perpustakaan: CorGuids.lib

Versi .NET: Tersedia sejak .NET Framework 2.0