共用方式為

winHTTP.h) (URL_COMPONENTS結構

  • 發行項

URL_COMPONENTS結構包含 URL 的組成部分。 此結構會與WinHttpC，以及 WinHttpCreateUrl函式搭配使用。

語法

typedef struct _WINHTTP_URL_COMPONENTS {
  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_COMPONENTS, *LPURL_COMPONENTS;

成員

dwStructSize

這個 結構的大小，以位元組為單位。 用於版本檢查。 必須設定此結構的大小，才能正確初始化這個結構。

lpszScheme

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

dwSchemeLength

配置名稱的長度，以字元為單位。

nScheme

網際網路通訊協定配置。 這個成員可以是下列其中一個值。

值 意義
INTERNET_SCHEME_HTTP
1
 網際網路配置是 HTTP 通訊協定。 如需詳細資訊 ，請參閱 RFC 2616 。
INTERNET_SCHEME_HTTPS
2
 網際網路配置 HTTPS 是使用安全交易語意的 HTTP 通訊協定。

lpszHostName

包含主機名稱的字串值指標。

dwHostNameLength

主機名稱的長度，以字元為單位。

nPort

連接埠號碼。

lpszUserName

包含使用者名稱的字串指標。

dwUserNameLength

使用者名稱的長度，以字元為單位。

lpszPassword

包含密碼的字串指標。

dwPasswordLength

密碼的長度，以字元為單位。

lpszUrlPath

包含 URL 路徑的字串指標。

dwUrlPathLength

URL 路徑的長度，以字元為單位。

lpszExtraInfo

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

dwExtraInfoLength

不帶正負號的長整數值，包含額外資訊的長度，以字元為單位。

備註

針對 WinHttpC， 如果指標成員及其對應的長度成員都是零，則不會傳回該 URL 的元件。 如果指標成員為 Null ，但長度成員不是零，則會傳回指標和長度成員。 如果指標和對應的長度成員都是非零的，則指標成員會指向複製元件所在的緩衝區。 所有逸出序列都可以從元件中移除，視WinHttpClagUrl的dwFlags參數而定。

對於 WinHttpCreateUrl 函式，如果不需要 URL 的元件，則指標成員應該是 Null 。 如果對應的長度成員為零，則指標成員是零終止字串的指標。 如果長度成員不是零，則為對應指標成員的字串長度。

注意 針對 Windows XP 和 Windows 2000，請參閱 WinHttp 起始頁的 執行時間需求 一節。
 

規格需求

   
最低支援的用戶端 Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003、具有 SP3 的 Windows 2000 Server [僅限傳統型應用程式]
標頭 winHTTP.h
可轉散發套件 Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更新版本。

另請參閱

WinHTTP 版本