Compartir a través de

Plantilla de función winrt::try_create_instance (C++/WinRT)

  • Artículo

Plantilla de función que crea un único objeto sin inicializar de la clase asociada a un CLSID especificado y lo devuelve como winrt::com_ptr o un com_ptr vacío si no se ejecuta correctamente.

Sintaxis

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

Parámetros de plantilla

typename Interface Tipo del puntero de interfaz que se va a consultar en el objeto recién creado.

Parámetros

clsid CLSID asociado a los datos y el código que se usarán para crear el objeto.

context Contexto en el que se ejecutará el código que administra el objeto recién creado. Los valores se toman de la enumeración CLSCTX.

outer Si nullptres , indica que el objeto no se está creando como parte de un agregado. Si no es nullptr, un puntero a la interfaz IUnknown del objeto agregado (el control IUnknown).

Valor devuelto

Winrt::com_ptr del objeto recién creado o un com_ptr vacío si no se realiza correctamente.

Requisitos

SDK mínimo admitido: Windows SDK versión 10.0.17134.0 (Windows 10, versión 1803)

Espacio de nombres: winrt

Encabezado: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluido de forma predeterminada)

Consulte también