URL_COMPONENTSW結構 (wininet.h)

包含 URL 的組成部分。 此結構會與 InternetC一Url 和 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

主機名的大小，以 TCHAR 為單位。

nPort

已轉換的埠號碼。

lpszUserName

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

dwUserNameLength

用戶名稱的大小，以 TCHAR 為單位。

lpszPassword

包含密碼的字串指標。

dwPasswordLength

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

lpszUrlPath

包含 URL 路徑的字串指標。

dwUrlPathLength

URL 路徑的大小，以 TCHAR 為單位。

lpszExtraInfo

字串的指標，其中包含 (的額外資訊，例如 ？something 或 #something) 。

dwExtraInfoLength

額外資訊的大小，以 TCHAR 為單位。

備註

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

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

注意 WinINet 不支援伺服器實作。 此外，不應該從服務使用它。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP Services (WinHTTP) 。

 

注意

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

規格需求

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

另請參閱

InternetC，Url

InternetCreateUrl