TranslateURLA 函式 (intshcut.h)

將一般翻譯套用至指定的 URL 字串，並建立新的 URL 字串。

語法

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

pcszURL

類型： PCTSTR

要翻譯之 URL 字串的位址。

dwInFlags

類型： DWORD

指定 URL 字串轉譯方式的位旗標。此值可以是下列各項的組合：

如果未在 pcszURL 參數中指定通訊協定配置到 TranslateURL，系統會自動選擇配置，並將它新增至URL。

如果未在 pcszURL 參數中指定通訊協定配置到 TranslateURL，系統會將預設通訊協定新增至URL。

[out] ppszTranslatedURL

類型： PTSTR*

指標變數，會接收新建立、翻譯URL字串的指標，如果有的話。只有在函式傳回S_OK時 ，ppszTranslatedURL 參數才有效。

類型： HRESULT

成功時傳回S_OK，如果 URL 不需要翻譯，則傳回 S_FALSE。如果發生錯誤，函式會傳回下列其中一個值。

此函式不會驗證輸入 URL 字串。成功的傳回值並不表示 URL 字串是有效的 URL。

注意

intshcut.h 標頭會將 TranslateURL 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。