IInternetExplorerManager::CreateObject method

Create a Windows Internet Explorer browser object based on the specified configuration options.

 

Syntax

HRESULT CreateObject(
  [in]         DWORD   dwConfig,
  [in, unique] LPCWSTR pszURL,
  [in]         REFIID  riid,
  [out]        void    **ppv
);

Parameters

• dwConfig [in]

  Value	Meaning
  INTERNETEXPLORERCONFIGURATION_HOST 0x0001	Start Internet Explorer with the following constraints: Disable first-run dialog and welcome page Disable crash and hang recovery Disable toolbars and browser helper objects (BHOs) Return a low integrity level IWebBrowser2 instance

   

• pszURL [in]
  Reserved for future use. Must be NULL.

• riid [in]
  The interface ID of the pointer returned in ppv.

• ppv [out]
  Address of a pointer that receives the new object instance.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

By default, regardless of the value passed in dwConfig, this method always creates instances of Internet Explorer that have the following characteristics:

• No frame merging
• Isolated from CLSID_InternetExplorer and other instances of Internet Explorer
• Isolated from other windows created using CLSID_InternetExplorerManager
• All tabs for the frame run in a single tab process
• No Enhanced Protected Mode (EPM), even if EPM is enabled in Internet Explorer

Requirements

Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
IDL	Ieautomation.idl

See also

IInternetExplorerManager