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。 如果發生錯誤,函式會傳回下列其中一個值。
傳回碼 | Description |
---|---|
|
傳入 dwInFlags 的旗標組合無效。 |
|
記憶體不足,無法完成作業。 |
|
其中一個輸入指標無效。 |
備註
此函式不會驗證輸入 URL 字串。 成功的傳回值並不表示 URL 字串是有效的 URL。
注意
intshcut.h 標頭會將 TranslateURL 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | intshcut.h |
Dll | Url.dll |