TranslateURLW 函数 (intshcut.h)

将常见翻译应用于给定的 URL 字符串,创建新的 URL 字符串。

语法

INTSHCUTAPI HRESULT TranslateURLW(
        PCWSTR pcszURL,
        DWORD  dwInFlags,
  [out] PWSTR  *ppszTranslatedURL
);

parameters

pcszURL

类型: PCTSTR

要转换的 URL 字符串的地址。

dwInFlags

类型:DWORD

指定如何转换 URL 字符串的位标志。 该值可为以下项的组合:

TRANSLATEURL_FL_GUESS_PROTOCOL

如果未在 TranslateURLpcszURL 参数中指定协议方案,则系统会自动选择一个方案并将其添加到 URL。

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

如果未在 TranslateURLpcszURL 参数中指定协议方案,系统会将默认协议添加到 URL。

[out] ppszTranslatedURL

类型: PTSTR*

一个指针变量,用于接收指向新创建的已翻译 URL 字符串(如果有)的指针。 仅当函数返回S_OK时, ppszTranslatedURL 参数才有效。

返回值

类型: HRESULT

成功时返回S_OK;如果 URL 不需要翻译,则返回S_FALSE。 如果发生错误,该函数将返回以下值之一。

返回代码 说明
E_FLAGS
在 dwInFlags 中传递的标志组合无效。
E_OUTOFMEMORY
内存不足,无法完成操作。
E_POINTER
其中一个输入指针无效。

注解

此函数不验证输入 URL 字符串。 成功的返回值并不表示 URL 字符串是有效的 URL。

注意

intshcut.h 标头将 TranslateURL 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 intshcut.h
DLL Url.dll