TranslateUrl method

Enables the host to modify the URL to be loaded.


HRESULT retVal = object.TranslateUrl(dwTranslate, pchURLIn, ppchURLOut);


  • dwTranslate [in]
    Type: DWORD

    Reserved. Must be set to NULL.

  • pchURLIn [in]
    Type: OLECHAR

    A pointer to an OLECHAR that specifies the current URL for navigation.

  • ppchURLOut [out]
    Type: OLECHAR

    A pointer variable that receives an OLECHAR pointer containing the new URL.


The host allocates the buffer ppchURLOut by using CoTaskMemAlloc.

If the implementation of this method does not supply a URL, set ppchURLOut to NULL, even if the method fails or returns S_FALSE.