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.h 标头将 URL_COMPONENTS 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
标头 | wininet.h |