URL_COMPONENTSA 結構 (wininet.h)

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

語法

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

成員

dwStructSize

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

lpszScheme

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

dwSchemeLength

配置名稱的大小，以 TCHAR 為單位。

nScheme

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

lpszHostName

包含主機名的字串指標。

dwHostNameLength

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

nPort

已轉換的埠號碼。

lpszUserName

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

dwUserNameLength

TCHAR 中用戶名稱的大小。

lpszPassword

包含密碼的字串指標。

dwPasswordLength

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

lpszUrlPath

包含 URL 路徑的字串指標。

dwUrlPathLength

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

lpszExtraInfo

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

dwExtraInfoLength

TCHAR 中額外資訊的大小。

備註

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

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

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

 

注意

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

規格需求

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

另請參閱

InternetCrackUrl

InternetCreateUrl