Partager via


AtlAxCreateControl

Crée un contrôle ActiveX, l'initialise, et le héberge dans la fenêtre spécifiée.

Important

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

ATLAPI AtlAxCreateControl(
LPCOLESTR lpszName,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnkContainer 
);

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> »

      [!REMARQUE]

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

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

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

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

Valeur de retour

L'une des valeurs HRESULT standard.

Notes

Cette fonction globale vous donne le même résultat que l'appel AtlAxCreateControlEx( lpszName**,** hWnd**,** pStream**, NULL, NULL, NULL, NULL** ;).

Pour créer un contrôle ActiveX autorisé, consultez l' AtlAxCreateControlLic.

Configuration requise

Header: atlhost.h

Voir aussi

Référence

CAxWindow::CreateControl

Concepts

Notions de base du contrôle composite

Autres ressources

Fonctions globales de contrôle composite