IDocHostUIHandler::TranslateUrl Method

---

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

Syntax

HRESULT TranslateUrl(
    DWORD dwTranslate, 
    OLECHAR *pchURLIn,
    OLECHAR **ppchURLOut    
);

Parameters

dwTranslate

Reserved for future use.

pchURLIn

Address of a string supplied by 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

Returns S_OK if the URL was translated, or S_FALSE if the URL was not translated.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0