HandleT 클래스

개체에 대한 핸들을 나타냅니다.

구문

template <typename HandleTraits>
class HandleT;

매개 변수

HandleTraits
핸들의 일반적인 특성을 정의하는 HandleTraits 구조체의 인스턴스입니다.

멤버

공용 Typedefs

이름	설명
Traits	HandleTraits의 동의어입니다.

공용 생성자

속성	설명
HandleT::HandleT	HandleT 클래스의 새 인스턴스를 초기화합니다.
HandleT::~HandleT	클래스의 인스턴스를 초기화합니다 HandleT .

공용 메서드

이름	설명
HandleT::Attach	지정된 핸들을 현재 HandleT 개체와 연결합니다.
HandleT::Close	현재 HandleT 개체를 닫습니다.
HandleT::D etach	현재 HandleT 개체를 내부 핸들에서 연결 해제합니다.
HandleT::Get	기본 핸들의 값을 가져옵니다.
HandleT::IsValid	현재 HandleT 개체가 핸들을 나타내는지 여부를 나타냅니다.

보호된 메서드

속성	설명
HandleT::InternalClose	현재 HandleT 개체를 닫습니다.

Public 연산자

이름	설명
HandleT::operator=	지정된 HandleT 개체의 값을 현재 HandleT 개체로 이동합니다.

보호된 데이터 멤버

이름	설명
HandleT::handle_	개체가 나타내는 핸들을 HandleT 포함합니다.

상속 계층 구조

HandleT

요구 사항

헤더: corewrappers.h

네임스페이스: Microsoft::WRL::Wrappers

HandleT::~HandleT

클래스의 인스턴스를 초기화합니다 HandleT .

~HandleT();

HandleT::Attach

지정된 핸들을 현재 HandleT 개체와 연결합니다.

void Attach(
   typename HandleTraits::Type h
);

매개 변수

시간
핸들입니다.

HandleT::Close

현재 HandleT 개체를 닫습니다.

void Close();

설명

현재 HandleT 를 기초로 하는 핸들이 닫히고 HandleT 잘못된 상태로 설정됩니다.

핸들이 제대로 닫히지 않은 경우 호출 스레드에서 예외가 발생합니다.

HandleT::D etach

현재 HandleT 개체를 내부 핸들에서 연결 해제합니다.

typename HandleTraits::Type Detach();

Return Value

기본 핸들입니다.

설명

이 작업이 완료되면 현재 HandleT 상태가 잘못된 상태로 설정됩니다.

HandleT::Get

기본 핸들의 값을 가져옵니다.

typename HandleTraits::Type Get() const;

Return Value

핸들입니다.

HandleT::handle_

개체가 나타내는 핸들을 HandleT 포함합니다.

typename HandleTraits::Type handle_;

HandleT::HandleT

HandleT 클래스의 새 인스턴스를 초기화합니다.

explicit HandleT(
   typename HandleTraits::Type h =
      HandleTraits::GetInvalidValue()
);

HandleT(
   _Inout_ HandleT&& h
);

매개 변수

시간
핸들입니다.

설명

첫 번째 생성자는 개체에 HandleT 대한 유효한 핸들이 아닌 개체를 초기화합니다. 두 번째 생성자는 매개 변수 h에서 새 HandleT 개체를 만듭니다.

HandleT::InternalClose

현재 HandleT 개체를 닫습니다.

virtual bool InternalClose();

Return Value

true 현재 HandleT 가 성공적으로 닫혔으면 false.입니다.

설명

InternalClose()은 protected입니다.

HandleT::IsValid

현재 HandleT 개체가 핸들을 나타내는지 여부를 나타냅니다.

bool IsValid() const;

Return Value

true 핸들을 나타내면 HandleT 이고, false그렇지 않으면 .입니다.

HandleT::operator=

지정된 HandleT 개체의 값을 현재 HandleT 개체로 이동합니다.

HandleT& operator=(
   _Inout_ HandleT&& h
);

매개 변수

시간
핸들에 대한 rvalue 참조입니다.

Return Value

현재 HandleT 개체에 대한 참조입니다.

설명

이 작업은 매개 변수 h로 HandleT 지정된 개체를 무효화합니다.