通过

TranslateURLA 函数 （intshcut.h）

  • 项目

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

语法

INTSHCUTAPI HRESULT TranslateURLA(
        PCSTR pcszURL,
        DWORD dwInFlags,
  [out] PSTR  *ppszTranslatedURL
);

参数

pcszURL

类型：PCTSTR

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

dwInFlags

类型：DWORD

指定如何转换 URL 字符串的位标志。 此值可以是以下内容的组合：

TRANSLATEURL_FL_GUESS_PROTOCOL

如果未在 pcszURL 参数中指定协议方案以 TranslateURL，系统将自动选择方案并将其添加到 URL。

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

如果未在 pcszURL 参数中指定协议方案来 TranslateURL，系统将默认协议添加到 URL。

[out] ppszTranslatedURL

类型：PTSTR*

一个指针变量，用于接收指向新创建的已转换 URL 字符串的指针（如果有）。 仅当函数返回S_OK时，ppszTranslatedURL 参数才有效。

返回值

类型：HRESULT

如果 URL 不需要翻译，则返回S_OK，或S_FALSE。 如果发生错误，该函数将返回以下值之一。

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

言论

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

注意

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

要求

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