다음을 통해 공유

winrt::create_instance 함수 템플릿(C++/WinRT)

  • 아티클

지정된 CLSID와 연결된 클래스의 초기화되지 않은 단일 개체를 만들고 winrt::com_ptr 반환하거나 실패하면 throw하는 함수 템플릿입니다.

구문

template <typename Interface>
winrt::com_ptr<Interface> create_instance(guid const& clsid,
    uint32_t context = 0x1 /*CLSCTX_INPROC_SERVER*/,
    void* outer = nullptr);

템플릿 매개 변수

typename Interface 새로 만든 개체에 대해 쿼리할 인터페이스 포인터의 형식입니다.

매개 변수

clsid 개체를 만드는 데 사용할 데이터 및 코드와 연결된 CLSID입니다.

context 새로 만든 개체를 관리하는 코드가 실행되는 컨텍스트입니다. 값은 열거형 CLSCTX에서 가져옵니다.

outer 이면 nullptr개체가 집계의 일부로 만들어지지 않음을 나타냅니다. 그렇지 않은 nullptr경우 집계 개체의 IUnknown 인터페이스(제어 IUnknown)에 대한 포인터입니다.

반환 값

새로 만든 개체의 winrt::com_ptr . 성공하지 못하면 throw합니다.

요구 사항

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

네임스페이스: winrt

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

참고 항목