Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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)