다음을 통해 공유


ICorDebugProcess2::GetReferenceValueFromGCHandle 메서드

가비지 수집 핸들이 있는 지정된 관리 개체에 대한 참조 포인터를 가져옵니다.

구문

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

매개 변수

handle [in] 가비지 수집 핸들이 있는 관리되는 개체에 대한 포인터입니다. 이 값은 IntPtr 개체이며 관리형 개체의 GCHandle에서 검색할 수 있습니다.

pOutValue [out] 지정된 관리되는 개체에 대한 참조를 나타내는 ICorDebugReferenceValue 개체의 주소에 대한 포인터입니다.

설명

반환된 참조 값과 가비지 수집 참조 값을 혼동하지 마세요.

반환된 참조는 일반 참조처럼 동작합니다. 중단점 이후에 코드 실행이 계속되면 사용하지 않도록 설정됩니다. 대상 개체의 수명은 참조 값의 수명에 의해 영향을 받지 않습니다.

참고 항목

GetReferenceValueFromGCHandle 메서드는 핸들의 유효성을 검사하지 않습니다. 따라서 GetReferenceValueFromGCHandle 메서드는 잘못된 핸들이 전달되면 디버거와 디버깅 중인 코드를 모두 손상시킬 수 있습니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: CorDebug.idl, CorDebug.h

라이브러리: CorGuids.lib

.NET Framework 버전: 2.0부터 사용 가능