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 指示 Internet 协议方案的值。

lpszHostName

指向包含主机名的字符串的指针。

dwHostNameLength

主机名的大小，以 TCHAR为单位。

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