TranslateURLA 函数 (intshcut.h)

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

语法

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

pcszURL

类型： PCTSTR

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

dwInFlags

类型：DWORD

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

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

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

[out] ppszTranslatedURL

类型： PTSTR*

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

类型： HRESULT

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

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

注意

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