winrt:: copy_from_abi 함수 (C++/winrt)winrt::copy_from_abi function (C++/WinRT)

핸들 또는 원시 포인터에서 C++/winrt 개체로 복사 하는 도우미 함수입니다.A helper function that copies to a C++/WinRT object from a handle, or from a raw pointer. C++/Winrt 개체를 지우거 나 현재 참조 된 인터페이스의 참조 횟수를 감소 시키고, 매개 변수를 복사 하 고,이에 의해 가리키는 핸들 또는 인터페이스를 관리 하기 시작 합니다 (매개 변수에 대 한 참조 횟수 증분 포함).Clears the C++/WinRT object, or decrements the reference count on any currently referenced interface, copies the parameter, and begins managing the handle or interface pointed to by it (which includes incrementing any reference count on the parameter). 자세한 내용과 코드 예제는 /Winrt와 ABI C++간의 상호 운용성을 참조 하세요.For more info, and code examples, see Interop between C++/WinRT and the ABI.


template <typename T, typename V, typename =
std::enable_if_t<!std::is_base_of_v<winrt::Windows::Foundation::IUnknown, T>>>
void copy_from_abi(T& object, V&& value);

void copy_from_abi(winrt::hstring& object, void* value);

void copy_from_abi(winrt::Windows::Foundation::IUnknown& object, void* value) noexcept;

매개 변수Parameters

작업할/Winrt 개체를 C++object 합니다.object A C++/WinRT object to operate on.

핸들이 나 C++/cx 개체에서 수명을 관리 해야 하는 대상에 대 한 원시 포인터를 value 합니다.value A handle, or a raw pointer to a target whose lifetime should be managed by the C++/WinRT object. IUnknown&, void* 오버 로드의 경우 함수는 valueon AddRef 를 호출 합니다.In the case of the IUnknown&, void* overload, the function calls AddRef on value.

요구 사항Requirements

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

네임 스페이스: winrtNamespace: winrt

헤더 % windowssdkdir% 포함<Windowssdkdir > \cppwinrt\winrt\base.h (기본적으로 포함 됨)Header %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (included by default)

참고 항목See also