Поделиться через

Шаблон функции winrt::create_instance (C++/WinRT)

  • Статья

Шаблон функции, создающий один неинициализированный объект класса, связанный с указанным CLSID, и возвращает его в виде winrt::com_ptr или создает исключение, если оно не выполнено.

Синтаксис

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 только что созданного объекта. Создает исключение, если оно не выполнено.

Требования

Минимальный поддерживаемый пакет SDK: пакет SDK Windows версии 10.0.17134.0 (Windows 10 версии 1803)

Пространство имен: winrt

Заголовок: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (включен по умолчанию)

См. также раздел