C++/WinRT 문제 해결

  • 아티클

참고 항목

프로젝트 템플릿 지원을 제공하는 C++/WinRT VSIX(Visual Studio Extension)를 설치 및 사용하는 방법에 대한 자세한 내용은 Visual Studio의 C++/WinRT 지원을 참조하세요.

이 항목은 당장 필요하지 않더라도 바로 파악할 수 있도록 사전 정보로 제공되었습니다. 아래 문제 해결 표의 증상과 해결 방법은 새 코드를 잘라내든, 기존 앱을 포팅하든 간에 유용할 수 있습니다. 포팅 중이며 프로젝트를 빌드 및 실행하는 단계까지 빠르게 도달하려는 경우 문제가 발생하는, 중요하지 않은 코드를 주석으로 처리하거나 스텁한 후 나중에 돌아가서 문제를 해결하면 일시적으로 진행할 수 있습니다.

자주 묻는 질문 목록은 자주 묻는 질문을 참조하세요.

XAML 문제 추적

예외 내에서 의미 있는 오류 메시지가 없는 경우에 특히 XAML 구문 분석 예외를 진단하는 것이 어려울 수 있습니다. 디버거가 초기에 구문 분석 예외를 시도하여 catch하기 위해 첫 번째 예외를 catch하도록 구성되었는지 확인합니다. 디버거에서 예외 변수를 검사하여 HRESULT 또는 메시지에 유용한 정보가 있는지 여부를 확인할 수 있습니다. 또한 Visual Studio의 출력 창에서 XAML 파서의 오류 메시지 출력을 확인합니다.

앱이 종료되고 XAML 태그 구문 분석 중 처리되지 않은 예외가 throw되었다는 것만 알 수 있는 경우 누락된 리소스를 키로 참조한 결과일 수 있습니다. 또는 UserControl, 사용자 지정 컨트롤 또는 사용자 지정 레이아웃 패널 내에서 예외가 throw되었을 수 있습니다. 이진 분할은 최후의 수단입니다. XAML 페이지에서 태그의 절반 정도를 제거하고 앱을 다시 실행합니다. 그러면 오류가 제거한 절반(어떤 경우든지 지금 복원해야 함)에서 발생했는지, 제거하지 않은 절반에서 발생했는지를 알 수 있습니다. 문제가 없어질 때까지 오류가 격리된 쪽을 분할하여 프로세스를 반복합니다.

증상 및 해결 방법

증상 해결 방법
HRESULT 값이 REGDB_E_CLASSNOTREGISTERED일 때 런타임에서 예외가 throw됩니다. "클래스가 등록되지 않음" 예외가 발생하는 이유는 무엇인가요?를 참조하세요.
C++ 컴파일러에서 “’implements_type’: ‘<projected type>’의 직접 또는 간접 기본 클래스에 속하는 멤버가 아닙니다.” 오류를 생성합니다. 이 오류는 네임스페이스로 한정되지 않은 구현 형식 이름(예: MyRuntimeClass)으로 make를 호출하고 해당 형식의 헤더를 포함하지 않은 경우에 발생할 수 있습니다. 컴파일러가 MyRuntimeClass를 프로젝션된 형식으로 해석합니다. 해결 방법은 구현 형식의 헤더(예: MyRuntimeClass.h)를 포함하는 것입니다.
C++ 컴파일러에서 “삭제된 함수를 참조하려고 합니다.” 오류를 생성합니다. 이 오류는 make를 호출하고 템플릿 매개 변수로 전달하는 구현 형식에 = delete 기본 생성자가 있는 경우에 발생할 수 있습니다. 구현 형식의 헤더 파일을 편집하여 = delete를 = default로 변경합니다. 런타임 클래스의 IDL에 생성자를 추가할 수도 있습니다.
INotifyPropertyChanged를 구현했지만 XAML 바인딩이 업데이트되지 않고 UI가 PropertyChanged를 구독하지 않습니다. XAML 태그의 바인딩 식에서 Mode=OneWay(또는 TwoWay)를 설정해야 합니다. XAML 컨트롤, C++/WinRT 속성에 바인딩을 참조하세요.
식별할 수 있는 컬렉션에 XAML 항목 컨트롤을 바인딩하고 있으며, 런타임에 예외가 throw되고 “매개 변수가 잘못되었습니다.” 메시지가 표시됩니다. IDL 및 구현에서 식별할 수 있는 모든 컬렉션을 Windows.Foundation.Collections.IVector<IInspectable> 형식으로 선언합니다. 단, Windows.Foundation.Collections.IObservableVector<T>를 구현하는 개체를 반환합니다. 여기서 T는 요소 형식입니다. XAML 항목 컨트롤, C++/WinRT 컬렉션에 바인딩을 참조하세요.
C++ 컴파일러에서 “‘MyImplementationType_base<MyImplementationType>’: 사용할 수 있는 적절한 기본 생성자가 없습니다.” 형식의 오류를 생성합니다. 이 오류는 특수한 생성자가 있는 형식에서 파생한 경우에 발생할 수 있습니다. 파생 형식의 생성자가 기본 형식의 생성자에 필요한 매개 변수를 전달해야 합니다. 처리된 예제는 특수 생성자가 있는 형식에서 파생을 참조하세요.
C++ 컴파일러에서 “‘const std::vector<std::wstring,std::allocator<_Ty>>’에서 ‘const winrt::param::async_iterable<winrt::hstring> &’로 변환할 수 없습니다.” 오류를 생성합니다. 이 오류는 std::wstring의 std::vector를 컬렉션이 필요한 Windows 런타임 API에 전달하는 경우에 발생할 수 있습니다. 자세한 내용은 표준 C++ 데이터 형식 및 C++/WinRT를 참조하세요.
C++ 컴파일러에서 “‘const std::vector<winrt::hstring,std::allocator<_Ty>>’에서 ‘const winrt::param::async_iterable<winrt::hstring> &’로 변환할 수 없습니다.” 오류를 생성합니다. 이 오류는 winrt::hstring의 std::vector를 컬렉션이 필요한 비동기 Windows 런타임 API에 전달하고, 벡터를 비동기 호출 수신자로 복사하거나 이동하지 않은 경우에 발생할 수 있습니다. 자세한 내용은 표준 C++ 데이터 형식 및 C++/WinRT를 참조하세요.
프로젝트를 열 때 Visual Studio에서 “프로젝트에 대한 애플리케이션이 설치되어 있지 않습니다.” 오류를 생성합니다. C++ 개발용 Windows 유니버설 도구를 아직 설치하지 않은 경우 Visual Studio의 새 프로젝트 대화 상자에서 설치해야 합니다. 그래도 문제가 해결되지 않으면 프로젝트에서 C++/WinRT VSIX(Visual Studio Extension)를 사용할 수 있습니다(Visual Studio의 C++/WinRT 지원 참조).
Windows 앱 인증 키트 테스트에서 런타임 클래스 중 하나가 “Windows 기본 클래스에서 파생되지 않았습니다. 구성 가능한 모든 클래스는 궁극적으로 Windows 네임스페이스의 형식에서 파생되어야 합니다.” 오류를 생성합니다. 기본 클래스에서 파생된 런타임 클래스(애플리케이션에서 선언)를 ‘구성 가능’ 클래스라고 합니다. 구성 가능 클래스의 최종 기본 클래스는 Windows.* 네임스페이스에서 시작되는 형식(예: Windows.UI.Xaml.DependencyObject)이어야 합니다. 자세한 내용은 XAML 컨트롤, C++/WinRT 속성에 바인딩을 참조하세요.
C++ 컴파일러가 EventHandler 또는 TypedEventHandler 대리자 전문화에 대해 "T는 WinRT 형식이어야 합니다."라는 오류 메시지를 생성합니다. winrt::delegate<...T>를 대신 사용하세요. C++/WinRT의 이벤트 작성을 참조하세요.
C++ 컴파일러가 Windows 런타임 비동기 작업 전문화에 대해 "T는 WinRT 형식이어야 합니다."라는 오류를 생성합니다. PPL(병렬 패턴 라이브러리) 작업을 대신 반환하세요. 동시성 및 비동기 작업을 참조하세요.
C++ 컴파일러가 winrt::xaml_typename을 호출할 때 "T는 WinRT 형식이어야 합니다."라는 오류를 생성합니다. winrt::xaml_typename의 프로젝션 형식(예: BgLabelControlApp::BgLabelControl 사용)을 사용하고, 구현 형식(BgLabelControlApp::implementation::BgLabelControl을 사용하지 않음)을 사용하지 마세요. XAML 사용자 지정(템플릿) 컨트롤을 참조하세요.
C++ 컴파일러에서 “오류 C2220: 경고가 오류로 처리되어 생성된 ‘object’ 파일이 없습니다.” 오류를 생성합니다. 경고를 수정하거나, C/C++>일반>경고를 오류로 처리를 아니요(/WX-)로 설정합니다.
개체 삭제 후 C++/WinRT 개체의 이벤트 처리기가 호출되어 앱 작동이 중단됩니다. 이벤트 처리 대리자를 사용하여 안전하게 this 포인터 액세스를 참조하세요.
C++ 컴파일러는 "오류 C2338: 약한 참조 지원에만 해당"을 생성합니다. 현재 winrt::no_weak_ref 마커 구조체를 템플릿 인수로 기본 클래스에 전달한 형식에 대해 약한 참조를 요청하고 있습니다. 약한 참조 지원 옵트아웃을 참조하세요.
C++ 컴파일러는 "'auto'를 반환하는 consume_Something: 함수는 정의되기 전에 사용할 수 없습니다"를 생성합니다. C3779: 컴파일러에서 "'auto'를 반환하는 consume_Something: 함수는 정의되기 전에 사용할 수 없습니다."라는 오류가 발생하는 이유는 무엇입니까?를 참조하세요.
C++ 링커는 "오류 LNK2019: 확인되지 않은 외부 기호"를 생성합니다. 링커에서 “LNK2019: 확인되지 않은 외부 기호” 오류가 발생하는 이유는 무엇인가요?를 참조합니다.
C++/WinRT에서 사용할 경우 LLVM 및 Clang 도구 체인에서 오류를 생성합니다. LLVM 및 Clang 도구 체인은 C++/WinRT에서 지원되지 않지만 내부적으로 사용하는 방법을 에뮬레이트하려는 경우 C++/WinRT로 컴파일하기 위해 LLVM/Clang을 사용할 수 있나요?에 설명된 것처럼 실험해 볼 수 있습니다.
C++ 컴파일러에서 프로젝션된 형식에 대해 “사용할 수 있는 적절한 기본 생성자가 없습니다.”를 생성합니다. 런타임 클래스 개체의 초기화를 지연하거나 동일한 프로젝트에서 런타임 클래스를 사용 및 구현하려는 경우, std::nullptr_t 생성자를 호출해야 합니다. 자세한 내용은 C++/WinRT를 통한 API 사용을 참조하세요.
C++ 컴파일러에서 “오류 C3861: ‘from_abi’: 식별자를 찾을 수 없습니다.” 및 base.h에서 시작되는 기타 오류를 생성합니다. 이 오류는 Visual Studio 2017(버전 15.8.0 이상)을 사용 중이며 Windows SDK 버전 10.0.17134.0(Windows 10, 버전 1803)을 대상으로 지정하는 경우에 표시될 수 있습니다. 보다 규칙에 맞는 Windows SDK 최신 버전을 대상으로 지정하거나, 프로젝트 속성 C/C++>언어>적합성 모드: 아니요를 설정합니다. 또는 추가 옵션 아래의 프로젝트 속성 C/C++>언어>명령줄에 /permissive-가 표시되는 경우 삭제합니다.
C++ 컴파일러에서 "오류 C2039: 'IUnknown': `'global namespace''의 멤버가 아닙니다."를 생성합니다. C++/WinRT 프로젝트의 대상을 Windows SDK 최신 버전으로 변경하는 방법을 참조하세요.
C++ 링커에서 "오류 LNK2019: 해결되지 않은 외부 기호 _WINRT_CanUnloadNow@0이 _VSDesignerCanUnloadNow@0 함수에서 참조됩니다."를 생성합니다. C++/WinRT 프로젝트의 대상을 Windows SDK 최신 버전으로 변경하는 방법을 참조하세요.
빌드 프로세스에서 C++/WinRT VSIX는 더 이상 프로젝트 빌드 지원을 제공하지 않습니다. Microsoft.Windows.CppWinRT Nuget 패키지에 대한 프로젝트 참조를 추가하세요. 오류 메시지를 생성합니다. Microsoft.Windows.CppWinRT NuGet 패키지를 프로젝트에 설치합니다. 자세한 내용은 이전 버전의 VSIX 확장을 참조하세요.
C++ 링커에서 winrt::impl::consume_Windows_Foundation_Collections_IVector에 대한 멘션과 함께 “오류 LNK2019: 확인되지 않은 외부 기호”를 생성합니다. C++/WinRT 2.0에서는 Windows 런타임 컬렉션에서 범위 기반의 for를 사용하는 경우 이제 #include <winrt/Windows.Foundation.Collections.h>가 필요합니다.
C++ 컴파일러에서 "오류 C4002: 함수 형식 매크로 호출 GetCurrentTime에 대한 인수가 너무 많습니다."를 생성합니다. GetCurrentTime 및/또는 TRY를 사용하여 모호성을 해결하려면 어떻게 하나요?를 참조하세요.
C++ 컴파일러에서 "오류 C2334: '{' 앞에 예기치 않은 토큰이 있습니다. 명백한 함수 본문을 건너뜁니다."를 생성합니다. GetCurrentTime 및/또는 TRY를 사용하여 모호성을 해결하려면 어떻게 하나요?를 참조하세요.
C++ 컴파일러에서 "GetBindingConnector가 없으므로 winrt::impl::produce<D,I>에서 추상 클래스를 인스턴스화할 수 없습니다."를 생성합니다. #include <winrt/Windows.UI.Xaml.Markup.h>를 수행해야 합니다.
C++ 컴파일러에서 "오류 C2039: 'promise_type':은 'std::experimental::coroutine_traits<void>'의 멤버가 아닙니다."를 생성합니다. 사용자 코루틴에서 비동기 작업 개체 또는 winrt::fire_and_forget 중 하나를 반환해야 합니다. 동시성 및 비동기 작업을 참조하세요.
사용자 프로젝트에서 "'PopulatePropertyInfoOverride' 액세스가 모호합니다."를 생성합니다. 이 오류는 IDL에서 하나의 기본 클래스를 선언하고 XAML 태그에서 다른 기본 클래스를 선언하는 경우에 발생할 수 있습니다.
처음으로 C++/WinRT 솔루션을 로드하면 "프로젝트 'MyProject.vcxproj' 구성 'Debug|x86'에 대한 Designtime 빌드에 실패했습니다. IntelliSense를 사용하지 못할 수 있습니다."가 생성됩니다. 이 IntelliSense 문제는 처음 빌드한 후 해결됩니다.
대리자 등록 시 winrt::auto_revoke를 지정하려고 하면 winrt::hresult_no_interface 예외를 생성합니다. 자동 취소 대리자를 등록하지 못하는 경우를 참조하세요.
C++/WinRT 앱에서 XAML을 사용하는 C# Windows 런타임 구성 요소를 사용할 때 컴파일러는 "'MyNamespace_XamlTypeInfo': is not a member of 'winrt::MyNamespace'" 형식의 오류를 발생합니다. 여기서 MyNamespace는 Windows 런타임 구성 요소의 네임스페이스 이름입니다. 사용하는 C++/WinRT 앱의 pch.h에서 MyNamespace를 적절하게 대체하는 #include <winrt/MyNamespace.MyNamespace_XamlTypeInfo.h>를 추가합니다.
Visual Studio의 C++/WinRT 프로젝트에서 IntelliSense가 "오류 E1696: 소스 파일을 열 수 없음" 형태의 오류를 생성합니다. 새로 만든 프로젝트를 한 번 이상 컴파일합니다. 그런 다음, 소스 코드 편집기에서 >다시 검사>파일 다시 검사를 마우스 오른쪽 단추로 클릭합니다. 그러면 E1696을 비롯한 모든 IntelliSense 오류가 해결됩니다.

참고 항목

이 항목에서 질문에 대한 답변을 찾지 못한 경우, Visual Studio C++ 개발자 커뮤니티를 방문하거나 Stack Overflow의 c++-winrt 태그를 사용하여 도움말을 찾을 수 있습니다.