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

  • Article

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

Syntax

template <typename Interface>
winrt::com_ptr<Interface> try_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 à rechercher 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, pointeur vers l’interface IUnknown de l’objet d’agrégation ( IUnknown de contrôle).

Valeur retournée

Winrt::com_ptr de l’objet nouvellement créé ou d’un com_ptr vide s’il n’a pas réussi.

Spécifications

Sdk minimum pris en charge : Windows SDK version 10.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