CreateTileProxy (Windows Embedded CE 6.0)

1/6/2010

This function creates a window for the host Web browser (TileHost) and a proxy (TileProxy) for that window.

Syntax

HRESULT CreateTileProxy(
  HWND hParentWnd,
  HWND hHtmlWnd,
  WNDPROC pfnWndProc,
  LPVOID pCreateParam,
  HANDLE* phTileProxy);

Parameters

• hParentWnd
  [in] Handle to the parent window of the TileHost window.

• hHtmlWnd
  [in] Optional. Handle to the HTML window with the class name Internet Explorer_Server, which is created by the Web browser control when the user first navigates to a page. You must attach the host Web browser to an HTML window for the TileHost window to work. If you do not set this optional parameter, you must later set it by using TPSetHtmlWindow.

• pfnWndProc
  [in] Long pointer to the window procedure that this function assigns to the host Web browser window.

• pCreateParam
  [in] Optional. Long pointer to additional data that the WM_CREATE message passes to the TileHost window.

  Before returning, this function sends a WM_CREATE message to the window procedure. The lParam parameter of WM_CREATE contains a pointer to a CREATESTRUCT structure. The lpCreateParams parameter of CREATESTRUCT contains a pointer to additional data that this function passes to the TileHost window. The pCreateParam parameter specifies this pointer.

• phTileProxy
  [out] Pointer to the TileProxy handle that you create by using this function.

Return Value

This function returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, in addition to the following:

• S_OK
  The method completed successfully.

Remarks

TileProxy provides a public interface to the tiling engine, exposing the functions for customizing the browser to an OEM or developer. The tiling engine (TileEngine) uses TileProxy to interact with the Web browser object (CWebBrowser).

In the IE XAML UI Sample browser, the name of the TileHost parent window, specified in the hParentWnd parameter, is "Internet Explorer 6.0 Sample EXR Browser".

Requirements

See Also

Other Resources

Internet Explorer Embedded Tiling Engine Functions
Error Values