CAxWindow::CreateControlEx

HRESULT CreateControlEx( LPCOLESTR lpszName, IStream* pStream = NULL, IUnknown** ppUnkContainer = NULL, IUnknown** ppUnkControl = NULL, REFIID iidSink = IID_NULL, IUnknown* punkSink = NULL );

HRESULT CreateControlEx( DWORD dwResID, IStream* pStream = NULL, IUnknown** ppUnkContainer = NULL, IUnknown** ppUnkControl = NULL, REFIID iidSink = IID_NULL, IUnknown* punkSink = NULL );

Return Value

A standard HRESULT value.

Parameters

lpszName

A pointer to a string to create 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>"
Note "MSHTML:" must precede the HTML fragment so that it is designated as being an MSHTML stream.

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.

ppUnkControl

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

dwResID

The resource ID of an HTML resource. The WebBrowser control will be created and loaded with the specified resource.

Remarks

Creates an ActiveX control, initializes it, and hosts it in the specified window. Use this function, instead of CreateControl, to retrieve interface pointers from the newly created control.

CAxWindow Overview | Class Members

See Also

AtlAxCreateControlEx