TranslateUrl method

Enables the host to modify the URL to be loaded.

Syntax

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

Parameters

• 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.

Remarks

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.