다음을 통해 공유

winrt::handle_type 구조체 템플릿(C++/WinRT)

  • 아티클

winrt::handle 및 winrt::file_handle 구조체에 대한 템플릿입니다.

메모

고유한 핸들 특성(예: \cppwinrt\winrt\base.hhandle_traits 또는 file_handle_traits 참조)을 정의하고 winrt::handle_typetypename T사용할 수 있습니다. base.h 이러한 예제 중 하나를 고유한 소스 코드 파일에 복사하고 고유한 핸들 형식 및 구현을 제공합니다. MSDN Magazine 문서 C++Windows에 대한 자세한 내용이 있습니다.

통사론

template <typename T>
struct handle_type

템플릿 매개 변수

typename T 표현되는 핸들의 종류(핸들, 파일 핸들 또는 다른 형식)를 지정하는 특성 형식입니다.

요구 사항

지원되는 최소 SDK: Windows SDK 버전 10.0.17134.0(Windows 10 버전 1803)

Namespace: 윈트

헤더: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h(기본적으로 포함)

멤버 형식 별칭

별칭 이름 형
handle_type::type Ttypename T 템플릿 매개 변수인 typename T::type동의어입니다.

생성자

생성자 묘사
handle_type::handle_type 생성자 필요에 따라 입력 데이터의 복사 또는 이동을 사용하여 handle_type 구조체의 새 인스턴스를 초기화합니다.

멤버 함수

기능 묘사
handle_type::attach 함수 핸들 값에 연결하고 핸들 값의 소유권을 가져옵니다.
handle_type::close 함수 기본 핸들을 닫습니다.
handle_type::d etach 함수 내부 핸들에서 분리합니다.
handle_type::get 함수 함수에 전달해야 하는 경우 기본 핸들을 반환합니다.
handle_type::p ut 함수 기본 핸들의 주소를 반환합니다. 이 함수는 핸들에 대한 포인터를 통해 참조를 out 매개 변수로 반환하는 메서드를 호출하는 데 도움이 됩니다.

멤버 연산자

연산자 묘사
handle_type::operator bool handle_type 개체가 현재 유효한 핸들을 나타내는지 여부를 확인합니다.
handle_type::operator=(대입 연산자) handle_type 개체에 값을 할당합니다.

Free 함수

기능 묘사
스왑 함수 서로의 핸들을 포함할 수 있도록 두 handle_type 매개 변수의 내용을 바꿉니다.

handle_type::handle_type 생성자

필요에 따라 입력 데이터의 복사 또는 이동을 사용하여 handle_type 구조체의 새 인스턴스를 초기화합니다.

통사론

handle_type() noexcept;
explicit handle_type(handle_type::type value) noexcept;
handle_type(handle_type&& other) noexcept;

매개 변수

value handle_type 개체를 초기화하는 값입니다.

other handle_type 개체를 초기화하는 다른 handle_type.

handle_type::attach 함수

핸들 값에 연결하고 핸들 값의 소유권을 가져옵니다.

통사론

void attach(handle_type::type value) noexcept;

매개 변수

value 연결할 핸들 값입니다.

handle_type::close 함수

기본 핸들을 닫습니다.

통사론

void close() noexcept;

handle_type::d etach 함수

내부 핸들에서 분리합니다.

통사론

handle_type::type detach() noexcept;

반환 값

이전에 handle_type 개체로 표현된 내부 핸들입니다.

handle_type::get 함수

함수에 전달해야 하는 경우 기본 핸들을 반환합니다.

통사론

handle_type::type get() const noexcept;

반환 값

handle_type 개체가 나타내는 기본 핸들입니다.

handle_type::p ut 함수

기본 핸들의 주소를 반환합니다. 이 함수는 핸들에 대한 포인터를 통해 참조를 out 매개 변수로 반환하는 메서드를 호출하는 데 도움이 됩니다.

통사론

handle_type::type* put() noexcept;

반환 값

handle_type 개체가 나타내는 내부 핸들의 주소입니다.

handle_type::operator bool

handle_type 개체가 현재 유효한 핸들을 나타내는지 여부를 확인합니다.

통사론

explicit operator bool() const noexcept;

반환 값

handle_type 개체가 현재 유효한 핸들을 나타내는지 true, 그렇지 않으면 false.

handle_type::operator=(대입 연산자)

handle_type 개체에 값을 할당합니다.

통사론

winrt::handle_type& operator=(winrt::handle_type&& other) noexcept;

매개 변수

handle_type 개체에 할당할 handle_type 값을 other.

반환 값

handle_type 개체에 대한 참조입니다.

swap 함수

서로의 핸들을 포함할 수 있도록 두 handle_type 매개 변수의 내용을 바꿉니다.

통사론

void swap(winrt::handle_type& left, winrt::handle_type& right) noexcept;

매개 변수

left right 핸들이 다른 매개 변수의 핸들과 상호 교환되는 handle_type 값입니다.

참고 항목