AtlAxCreateControlLic

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

ATLAPI AtlAxCreateControlLic(
   LPCOLESTR lpszName, 
   HWND hWnd, 
   IStream* pStream, 
   IUnknown** ppUnkContainer, 
   BSTR bstrLic = NULL
);

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
    Handle to the window that the control will be attached to.

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

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

  • bstrLic
    The BSTR containing the license for the control.

Return Value

One of the standard HRESULT values.

Example

See Hosting ActiveX Controls Using ATL AXHost for a sample of how to use AtlAxCreateControlLic.

Requirements

Header: atlhost.h

See Also

Reference

AtlAxCreateControl

CAxWindow2T::CreateControlLic

Concepts

Composite Control Fundamentals

Other Resources

Composite Control Global Functions