winrt::create_instance modèle de fonction (C++/WinRT)

  • Article

Modèle de fonction qui crée un objet non initialisé unique de la classe associée à un CLSID spécifié et le retourne en tant que winrt::com_ptr ou lève s’il n’a pas réussi.

Syntax

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

Paramètres de modèle

typename Interface Type du pointeur d’interface à interroger sur l’objet nouvellement créé.

Paramètres

clsid CLSID associé aux données et au code qui seront utilisés pour créer l’objet.

context Contexte dans lequel le code qui gère l’objet nouvellement créé s’exécute. Les valeurs sont extraites de l’énumération CLSCTX.

outer Si nullptr, indique que l’objet n’est pas créé dans le cadre d’un agrégat. Si ce n’est pas nullptrle cas, un pointeur vers l’interface IUnknown de l’objet d’agrégation (le contrôle d’IUnknown).

Valeur retournée

Winrt::com_ptr de l’objet nouvellement créé. Lève s’il n’a pas réussi.

Spécifications

Kit de développement logiciel (SDK) pris en charge minimum : Windows SDK version 10.0.0.17134.0 (Windows 10, version 1803)

Espace de noms : winrt

En-tête : %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (inclus par défaut)

Voir aussi