Condividi tramite

modello di funzione winrt::try_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 un com_ptr vuoto, se non riuscito.

Sintassi

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

Parametri di modelli

typename Interface Tipo del puntatore dell'interfaccia da eseguire per la query sull'oggetto appena creato.

Parametri

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

context Contesto in cui verrà eseguito il codice che gestisce l'oggetto appena creato. I valori vengono acquisiti 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 di IUnknown).

Valore restituito

Una com_ptr winrt::com_ptr dell'oggetto appena creato o un com_ptr vuoto se non ha esito positivo.

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