다음을 통해 공유


CHandle 클래스

이 클래스는 핸들 개체를 만들고 사용하는 메서드를 제공합니다.

구문

class CHandle

멤버

공용 생성자

속성 설명
CHandle::CHandle 생성자입니다.
CHandle::~CHandle 소멸자입니다.

공용 메서드

이름 설명
CHandle::Attach 개체를 기존 핸들에 CHandle 연결하려면 이 메서드를 호출합니다.
CHandle::Close 이 메서드를 호출하여 개체를 닫습니다 CHandle .
CHandle::D etach 개체에서 핸들을 분리하려면 이 메서드를 CHandle 호출합니다.

Public 연산자

속성 설명
CHandle::operator HANDLE 저장된 핸들의 값을 반환합니다.
CHandle::operator = 대입 연산자입니다.

공용 데이터 멤버

속성 설명
CHandle::m_h 핸들을 저장하는 멤버 변수입니다.

설명

CHandle 핸들이 필요할 때마다 개체를 사용할 수 있습니다. 주요 차이점은 개체가 CHandle 자동으로 삭제된다는 것입니다.

참고 항목

일부 API 함수는 NULL을 비어 있거나 잘못된 핸들로 사용하고 다른 함수는 INVALID_HANDLE_VALUE 사용합니다. CHandle NULL만 사용하고 INVALID_HANDLE_VALUE 실제 핸들로 처리합니다. INVALID_HANDLE_VALUE 반환할 수 있는 API를 호출하는 경우 CHandle::Attach를 호출하거나 생성자에 전달하기 전에 이 값을 확인하고 대신 NULL을 CHandle 전달해야 합니다.

요구 사항

헤더: atlbase.h

CHandle::Attach

개체를 기존 핸들에 CHandle 연결하려면 이 메서드를 호출합니다.

void Attach(HANDLE h) throw();

매개 변수

시간
CHandle 는 핸들 h의 소유권을 가져옵니다.

설명

h 핸들에 CHandle 개체를 할당한 다음 h.Detach()를 호출합니다. 디버그 빌드에서 h가 NULL인 경우 ATLASSERT가 발생합니다. 핸들의 유효성에 대한 다른 확인은 이루어지지 않습니다.

CHandle::CHandle

생성자입니다.

CHandle() throw();
CHandle(CHandle& h) throw();
explicit CHandle(HANDLE h) throw();

매개 변수

시간
기존 핸들 또는 CHandle.

설명

필요에 따라 기존 핸들 또는 CHandle 개체를 사용하여 새 CHandle 개체를 만듭니다.

CHandle::~CHandle

소멸자입니다.

~CHandle() throw();

설명

CHandle CHandle::Close를 호출하여 개체를 해제합니다.

CHandle::Close

이 메서드를 호출하여 개체를 닫습니다 CHandle .

void Close() throw();

설명

열린 개체 핸들을 닫습니다. 핸들이 NULL이면 이미 호출된 경우 Close 디버그 빌드에서 ATLASSERT가 발생합니다.

CHandle::D etach

개체에서 핸들을 분리하려면 이 메서드를 CHandle 호출합니다.

HANDLE Detach() throw();

Return Value

분리되는 핸들을 반환합니다.

설명

핸들의 소유권을 해제합니다.

CHandle::m_h

핸들을 저장하는 멤버 변수입니다.

HANDLE m_h;

CHandle::operator =

할당 연산자입니다.

CHandle& operator=(CHandle& h) throw();

매개 변수

시간
CHandle 는 핸들 h의 소유권을 가져옵니다.

Return Value

CHandle 개체에 대한 참조를 반환합니다.

설명

개체에 CHandle 현재 핸들이 포함되어 있으면 닫힙니다. 전달되는 개체에는 CHandle 해당 핸들 참조가 NULL로 설정됩니다. 이렇게 하면 두 CHandle 개체에 동일한 활성 핸들이 포함되지 않습니다.

CHandle::operator HANDLE

저장된 핸들의 값을 반환합니다.

operator HANDLE() const throw();

설명

CHandle::m_h 저장된 값을 반환합니다.

참고 항목

클래스 개요