AtlAxCreateControl

Creates an ActiveX control, initializes it, and hosts it in the specified window.

Important

This function cannot be used in applications that execute in the Windows Runtime.

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

Parameters

  • lpszName
    A pointer to a string to be passed to the control. Must be formatted in one of the following ways:

    • A ProgID such as "MSCAL.Calendar.7"

    • A CLSID such as "{8E27C92B-1264-101C-8A2F-040224009C02}"

    • A URL such as "https://www.microsoft.com"

    • A reference to an Active document such as "file://\\Documents\MyDoc.doc"

    • A fragment of HTML such as "MSHTML:<HTML><BODY>This is a line of text</BODY></HTML>"

      Note

      "MSHTML:" must precede the HTML fragment so that it is designated as being an MSHTML stream.

  • hWnd
    [in] Handle to the window that the control will be attached to.

  • pStream
    [in] A pointer to a stream that is used to initialize the properties of the control. Can be NULL.

  • ppUnkContainer
    [out] The address of a pointer that will receive the IUnknown of the container. Can be NULL.

Return Value

One of the standard HRESULT values.

Remarks

This global function gives you the same result as calling AtlAxCreateControlEx( lpszName**,** hWnd**,** pStream**, NULL, NULL, NULL, NULL** );.

To create a licensed ActiveX control, see AtlAxCreateControlLic.

Requirements

Header: atlhost.h

See Also

Reference

CAxWindow::CreateControl

Concepts

Composite Control Fundamentals

Other Resources

Composite Control Global Functions