IDocHostUIHandler::TranslateUrl Method
Enables the host to modify the URL to be loaded.
Syntax
HRESULT TranslateUrl( DWORD dwTranslate, OLECHAR *pchURLIn, OLECHAR **ppchURLOut );
Parameters
- dwTranslate
- [in] Reserved. Must be set to NULL.
- pchURLIn
- [in] A pointer to an OLECHAR that specifies the current URL for navigation.
- ppchURLOut
- [out] A pointer variable that receives an OLECHAR pointer containing the new URL.
Return Value
Returns S_OK if the URL was translated, or S_FALSE if the URL was not translated.
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.