UrlApplySchemeW 函式 (shlwapi.h)
決定指定 URL 字串的配置,並傳回具有適當前置詞的字串。
語法
LWSTDAPI UrlApplySchemeW(
[in] PCWSTR pszIn,
[out] PWSTR pszOut,
[in, out] DWORD *pcchOut,
DWORD dwFlags
);
參數
[in] pszIn
類型: PCTSTR
長度上限為 null 的字串,INTERNET_MAX_URL_LENGTH包含 URL。
[out] pszOut
類型: PTSTR
緩衝區的指標,當此函式成功傳回時,會收到 設定為 pszIn 所指定 URL 的 Null 終止字串,並轉換成標準 scheme://URL_string 格式。
[in, out] pcchOut
類型: DWORD*
值位址設定為 pszOut 緩衝區中的字元數。 當函式傳回時,值取決於函式是否成功或傳回E_POINTER。 對於其他傳回值,這個參數的值是無意義的。
dwFlags
類型: DWORD
指定如何判斷配置的旗標。 可以合併下列旗標。
URL_APPLY_DEFAULT
如果 UrlApplyScheme 無法判斷預設配置,請套用預設配置。 默認前置詞會儲存在登錄中,但通常是 「HTTP」。。
URL_APPLY_GUESSSCHEME
藉由檢查 pszIn 嘗試判斷配置。
URL_APPLY_GUESSFILE
嘗試從 pszIn 判斷檔案 URL。
URL_APPLY_FORCEAPPLY
強制 UrlApplyScheme 判斷 pszIn 的配置。
傳回值
類型: HRESULT
傳回標準 COM 傳回值,包括下列專案。
傳回碼 | 描述 |
---|---|
|
已決定配置。 pszOut 指向包含具有配置前置詞之 URL 的字串。 pcchOut 的值會設定為字串中的字元數,而不是計算終止的 NULL 字元。 |
|
沒有任何錯誤,但前面未加上前置詞。 |
|
緩衝區太小。 pcchOut 的值會設定為緩衝區必須能夠包含的最小字元數,包括終止的 NULL 字元。 |
備註
如果 URL 具有有效的配置,將不會修改字串。 不過,後面接著冒號的兩個或多個字元幾乎任何組合都會剖析為配置。 有效字元包含一些常見的標點符號,例如 “.”。 如果您的輸入字串符合此描述, UrlApplyScheme 可能會將其視為有效且不適用配置。 若要強制函式將配置套用至URL,請在 dwFlags 中設定URL_APPLY_FORCEAPPLY和URL_APPLY_DEFAULT旗標。 這個旗標組合會強制函式將配置套用至 URL。 一般而言,函式將無法判斷有效的配置。 第二個旗標保證,如果無法判斷有效的配置,函式會將預設配置套用至 URL。
注意
shlwapi.h 標頭會將 UrlApplyScheme 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional、Windows XP [僅限桌面應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shlwapi.h |
程式庫 | Shlwapi.lib |
Dll | Shlwapi.dll (5.0 版或更新版本) |