Partager via


AtlAxCreateControlLicEx

Crée un contrôle ActiveX autorisé, l'initialise, et le héberge dans la fenêtre spécifiée. Un pointeur d'interface et un récepteur d'événements pour le contrôle peuvent également être créés.

Important

Cette fonction ne peut pas être utilisée dans les applications qui s'exécutent dans Windows Runtime.

ATLAPI AtlAxCreateControlLicEx( 
LPCOLESTR lpszName,  
HWND hWnd,  
IStream* pStream, 
IUnknown** ppUnkContainer,  
IUnknown** ppUnkControl, 
REFIID iidSink = IID_NULL,  
IUnknown* punkSink = NULL,  
BSTR bstrLic= NULL 
);

Paramètres

  • lpszName
    Un pointeur vers une chaîne à passer au contrôle. Doit être mis en forme dans l'une des façons suivantes :

    • Un progid tel que « MSCAL.Calendar.7 »

    • Le CLSID (« {} » 8E27C92B-1264-101C-8A2F-040224009C02

    • UNE URL telle que « https://www.microsoft.com »

    • Une référence à un document actif tel que « \\Documents\MyDoc file:// » .doc

    • Un fragment HTML tel que « MSHTML :<HTML><BODY>cela est une ligne de text</body></html> »

      Notes

      « MSHTML :  » doit précéder le fragment de code HTML afin qu'il soit indiquée comme être un flux de MSHTML.

  • hWnd
    Handle dans la fenêtre que le contrôle est attaché.

  • pStream
    Un pointeur vers un flux qui est utilisé pour initialiser les propriétés du contrôle. Peut être NULL.

  • ppUnkContainer
    l'adresse d'un pointeur qui recevra IUnknown du conteneur. Peut être NULL.

  • ppUnkControl
    [out] l'adresse d'un pointeur qui recevra IUnknown du contrôle créé. Peut être NULL.

  • iidSink
    L'identificateur d'interface d'une interface sortante sur l'objet contenu.

  • punkSink
    Pointeur vers l'interface d' IUnknown de l'objet sink à connecter au point de connexion spécifié par iidSink sur l'objet contenu après que l'objet contenu a été correctement créé.

  • bstrLic
    BSTR contenant la clé de licence pour le contrôle.

Valeur de retour

L'une des valeurs HRESULT standard.

Notes

AtlAxCreateControlLicEx est semblable à AtlAxCreateControlLic mais vous permet également de recevoir un pointeur d'interface vers le contrôle que vous venez de créer et installer un récepteur d'événements pour recevoir des événements déclenchés par le contrôle.

Exemple

Consultez Contrôles ActiveX d'hébergement à l'aide de ATL AXHost pour obtenir un exemple d'utilisation AtlAxCreateControlLicEx.

Configuration requise

Header: atlhost.h

Voir aussi

Référence

AtlAxCreateControl

CAxWindow2T::CreateControlLicEx

Concepts

Notions de base du contrôle composite

Autres ressources

Fonctions globales de contrôle composite