共用方式為

UrlGetPartA 函式 （shlwapi.h）

  • 發行項

接受 URL 字串，並傳回該 URL 的指定部分。

語法

LWSTDAPI UrlGetPartA(
  [in]      PCSTR pszIn,
  [out]     PSTR  pszOut,
  [in, out] DWORD *pcchOut,
            DWORD dwPart,
            DWORD dwFlags
);

參數

[in] pszIn

類型：PCTSTR

包含 URL 之最大長度的 null 終止字串INTERNET_MAX_URL_LENGTH。

[out] pszOut

類型：PTSTR

緩衝區的指標，當此函式成功傳回時，會接收具有URL指定部分的 Null 終止字串。

[in, out] pcchOut

類型：DWORD*

項目上設定為 pszOut 緩衝區中 字元數的值指標。 當此函式成功傳回時，值取決於函式是否成功或傳回E_POINTER。 對於其他傳回值，這個參數的值毫無意義。

dwPart

類型：DWORD

指定要擷取之 URL 部分的旗標。 它可以有下列其中一個值。

URL_PART_HOSTNAME

主機名。

URL_PART_PASSWORD

密碼。

URL_PART_PORT

埠號碼。

URL_PART_QUERY

URL 的查詢部分。

URL_PART_SCHEME

URL 配置。

URL_PART_USERNAME

用戶名稱。

dwFlags

類型：DWORD

除了 dwPart 所指定的元件之外，還可以設定為保留 URL 配置的旗標。

URL_PARTFLAG_KEEPSCHEME

保留 URL 配置。

傳回值

類型：HRESULT

如果成功，則傳回S_OK。 pcchOut 所指向的值會設定為寫入輸出緩衝區的字元數，但不包括結束 NULL。 如果緩衝區太小，則會傳回E_POINTER，而且 pcchOut 所指向的值將會設定為緩衝區必須包含的字元數下限，包括終止 NULL 字元。 否則會傳回 COM 錯誤值。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlwapi.h
連結庫 Shlwapi.lib
DLL Shlwapi.dll 版 （5.0 版或更新版本）