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) 。

dwExtraInfoLength

额外信息的大小，以 TCHAR 为单位。

注解

对于 InternetCrackUrl，如果指针成员及其相应的长度成员均为零，则不返回该组件。 如果指针成员为 NULL ，但长度成员不为零，则同时返回指针成员和长度成员。 如果指针和相应的长度成员都是非零成员，则指针成员指向复制组件的缓冲区。 组件可以取消转义，具体取决于 InternetCrackUrl 的 dwFlags 参数。

对于 InternetCreateUrl，如果不需要组件，指针成员应为 NULL 。 如果相应的长度成员为零，则指针成员是零终止字符串的地址。 如果长度成员不为零，则为相应指针成员的字符串长度。

注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。
 

注意

wininet.h 标头将 URL_COMPONENTS 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 wininet.h

另请参阅

InternetCrackUrl

InternetCreateUrl