共用方式為

URL_COMPONENTSW結構 （wininet.h）

  • 發行項

包含 URL 的組成部分。 此結構會與 InternetCrackUrl 和 InternetCreateUrl 函式搭配使用。

語法

typedef struct {
  DWORD           dwStructSize;
  LPWSTR          lpszScheme;
  DWORD           dwSchemeLength;
  INTERNET_SCHEME nScheme;
  LPWSTR          lpszHostName;
  DWORD           dwHostNameLength;
  INTERNET_PORT   nPort;
  LPWSTR          lpszUserName;
  DWORD           dwUserNameLength;
  LPWSTR          lpszPassword;
  DWORD           dwPasswordLength;
  LPWSTR          lpszUrlPath;
  DWORD           dwUrlPathLength;
  LPWSTR          lpszExtraInfo;
  DWORD           dwExtraInfoLength;
} URL_COMPONENTSW, *LPURL_COMPONENTSW;

成員

dwStructSize

這個結構的大小，以位元組為單位。

lpszScheme

包含配置名稱的字串指標。

dwSchemeLength

設定名稱的大小，TCHAR。

nScheme

INTERNET_SCHEME 值，表示因特網通訊協定配置。

lpszHostName

包含主機名的字串指標。

dwHostNameLength

主機名的大小，TCHARs。

nPort

已轉換的埠號碼。

lpszUserName

包含用戶名稱的字串值指標。

dwUserNameLength

使用者名稱的大小，TCHAR。

lpszPassword

包含密碼的字串指標。

dwPasswordLength

密碼的大小，以 TCHAR為單位。

lpszUrlPath

包含 URL 路徑的字串指標。

dwUrlPathLength

URL 路徑的大小，TCHAR。

lpszExtraInfo

包含額外資訊的字串指標（例如 ？something 或 #something）。

dwExtraInfoLength

額外資訊的大小，TCHAR。

言論

針對 InternetCrackUrl，如果指標成員及其對應的長度成員都是零，則不會傳回該元件。 如果指標成員 NULL 但長度成員不是零，則會傳回指標和長度成員。 如果指標和對應的長度成員都是非零，指標成員會指向複製元件所在的緩衝區。 元件可以解除逸出，視 internetCrackUrl dwFlags 參數而定。

針對 InternetCreateUrl，如果不需要元件，則指標成員應該 NULL。 如果對應的長度成員為零，則指標成員是零終止字串的位址。 如果長度成員不是零，則為對應指標成員的字串長度。

注意 WinINet 不支援伺服器實作。 此外，不應該從服務使用。 針對伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 （WinHTTP）。
 

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 wininet.h

另請參閱

InternetCrackUrl

InternetCreateUrl