modelo de função winrt::create_instance (C++/WinRT)

Artigo
07/20/2023

Um modelo de função que cria um único objeto não inicializado da classe associada a um CLSID especificado e o retorna como um winrt::com_ptr ou é lançado se não tiver êxito.

Syntax

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

Parâmetros de modelo

typename Interface O tipo do ponteiro de interface a ser consultado no objeto recém-criado.

Parâmetros

clsid O CLSID associado aos dados e ao código que serão usados para criar o objeto.

context Contexto no qual o código que gerencia o objeto recém-criado será executado. Os valores são obtidos da enumeração CLSCTX.

outer Se nullptr, indica que o objeto não está sendo criado como parte de uma agregação. Caso contrário nullptr, um ponteiro para a interface IUnknown do objeto de agregação (o IUnknown controlador).

Valor retornado

Um winrt::com_ptr do objeto recém-criado. Lança se não tiver êxito.

Requisitos

SDK mínimo com suporte: Windows SDK versão 10.0.17134.0 (Windows 10, versão 1803)

Namespace: winrt

Cabeçalho: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluído por padrão)

Share via