Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

AtlAxCreateControlLic

 

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

System_CAPS_importantImportant

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

Copy 

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

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 "http://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>"

    System_CAPS_noteNote

    "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.

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

Show: