共用方式為

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

成功時傳回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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 intshcut.h
DLL Url.dll