UrlCreateFromPathA 函式 (shlwapi.h)
將 Microsoft MS-DOS 路徑轉換為標準 URL。
語法
LWSTDAPI UrlCreateFromPathA(
[in] PCSTR pszPath,
[out] PSTR pszUrl,
[in, out] DWORD *pcchUrl,
DWORD dwFlags
);
參數
[in] pszPath
類型: PCTSTR
長度上限為 null 的字串,INTERNET_MAX_URL_LENGTH包含 MS-DOS 路徑。
[out] pszUrl
類型: PTSTR
緩衝區的指標,當此函式成功傳回時,會收到URL。
[in, out] pcchUrl
類型: DWORD*
pszUrl 中的字元數。
dwFlags
類型: DWORD
保留的。 將此參數設定為 NULL。
傳回值
類型: HRESULT
如果 pszPath 已經是 URL 格式,則傳回S_FALSE。 在此情況下, pszPath 只會複製到 pszUrl。 否則,如果成功,則會傳回S_OK,否則會傳回標準 COM 錯誤值。
備註
注意UrlCreateFromPath 不支援擴充路徑。 這些是包含延伸長度路徑前置詞 「\\?\」 的路徑。
注意
shlwapi.h 標頭會將 UrlCreateFromPath 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional、Windows XP [僅限桌面應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shlwapi.h |
程式庫 | Shlwapi.lib |
Dll | Shlwapi.dll (5.0 版或更新版本) |