IExplorerBrowser::Initialize method (shobjidl_core.h)

Prepares the browser to be navigated.

Syntax

HRESULT Initialize(
  [in] HWND                 hwndParent,
  [in] const RECT           *prc,
  [in] const FOLDERSETTINGS *pfs
);

Parameters

[in] hwndParent

Type: HWND

A handle to the owner window or control.

[in] prc

Type: const RECT*

A pointer to a RECT that contains the coordinates of the bounding rectangle that the browser will occupy. The coordinates are relative to hwndParent.

[in] pfs

Type: const FOLDERSETTINGS*

A pointer to a FOLDERSETTINGS structure that determines how the folder will be displayed in the view. If this parameter is NULL, then you must call IExplorerBrowser::SetFolderSettings; otherwise, the default view settings for the folder are used.

Return value

Type: HRESULT

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

Remarks

After calling the Initialize method, it is the responsibility of the caller to call the Destroy method to destroy the browser and free any memory and windowed resources associated with the browser.

Requirements