Modello di funzione winrt::create_instance (C++/WinRT)

  • Articolo

Modello di funzione che crea un singolo oggetto non inizializzato della classe associata a un CLSID specificato e lo restituisce come winrt::com_ptr o genera un'eccezione in caso di esito negativo.

Sintassi

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

Parametri di modelli

typename Interface Tipo del puntatore di interfaccia per cui eseguire una query sull'oggetto appena creato.

Parametri

clsid CLSID associato ai dati e al codice che verranno utilizzati per creare l'oggetto.

context Contesto in cui verrà eseguito il codice che gestisce l'oggetto appena creato. I valori vengono ricavati dall'enumerazione CLSCTX.

outer Se nullptr, indica che l'oggetto non viene creato come parte di un'aggregazione. In caso contrario nullptr, un puntatore all'interfaccia IUnknown dell'oggetto aggregato (controllo IUnknown).

Valore restituito

Winrt::com_ptr dell'oggetto appena creato. Genera se l'operazione non riesce.

Requisiti

SDK minimo supportato: Windows SDK versione 10.0.17134.0 (Windows 10, versione 1803)

Spazio dei nomi: winrt

Intestazione: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluso per impostazione predefinita)

Vedi anche