Share via


CHtmlView::OnTranslateUrl

Called by Internet Explorer or MSHTML to allow the host an opportunity to modify the URL to be loaded.

virtual HRESULT OnTranslateUrl( 
   DWORD dwTranslate, 
   OLECHAR* pchURLIn, 
   OLECHAR** ppchURLOut  
);

Parameters

  • dwTranslate
    Reserved for future use.

  • pchURLIn
    Address of a string supplied by Internet Explorer or MSHTML that represents the URL to be translated.

  • ppchURLOut
    Address of a string pointer that receives the address of the translated URL. The host allocates the buffer using the task memory allocator. The contents of this parameter should always be initialized to NULL, even if the URL is not translated or the method fails.

Return Value

S_OK if the URL was translated, S_FALSE if the URL was not translated, or an OLE-defined error code if an error occurred.

Remarks

Override OnTranslateUrl to react to the TranslateUrl notification from the Microsoft Web Browser control. See IDocHostUIHandler::TranslateUrl in the Windows SDK for more information.

Requirements

Header: afxhtml.h

See Also

Reference

CHtmlView Class

Hierarchy Chart