ICorDebugHeapValue2::CreateHandle 메서드

이 ICorDebugHeapValue2 개체가 나타내는 힙 값에 대해 지정된 형식의 핸들을 만듭니다.

Syntax

HRESULT CreateHandle (
    [in] CorDebugHandleType      type,
    [out] ICorDebugHandleValue   **ppHandle
);

매개 변수

type [in] 만들 핸들의 형식을 지정하는 CorDebugHandleType 열거형의 값입니다.

ppHandle [out] 이 힙 값의 새 핸들을 나타내는 ICorDebugHandleValue 개체의 주소에 대한 포인터입니다.

비고

핸들은 힙 값과 연결된 애플리케이션 도메인에 만들어지고 애플리케이션 도메인이 언로드되면 유효하지 않습니다.

동일한 힙 값에 대해 이 함수를 여러 차례 호출하면 여러 핸들이 생성됩니다. 핸들은 가비지 수집기의 성능에 영향을 주므로 디버거는 한 번에 활성 상태인 비교적 적은 수의 핸들(약 256개)으로 제한해야 합니다.

요구 사항

플랫폼:.NET 지원 운영 체제를 참조하세요.

머리글: CorDebug.idl, CorDebug.h

도서관: CorGuids.lib

.NET 버전: .NET Framework 2.0 이후 사용 가능