描述
URL_COMPONENTS结构包含URL的组成部分。该结构与WinHttpCrackUrl和WinHttpCreateUrl功能一起使用。
C / C ++语法
struct URL_COMPONENTS { DWORD dwStructSize; LPWSTR lpszScheme; DWORD dwSchemeLength; int nScheme; LPWSTR lpszHostName; DWORD dwHostNameLength; INTERNET_PORT nPort; LPWSTR lpszUserName; DWORD dwUserNameLength; LPWSTR lpszPassword; DWORD dwPasswordLength; LPWSTR lpszUrlPath; DWORD dwUrlPathLength; LPWSTR lpszExtraInfo; DWORD dwExtraInfoLength; }; |
PowerBASIC 语法
TYPE URL_COMPONENTS dwStructSize AS DWORD lpszScheme AS WSTRINZ PTR dwSchemeLength AS DWORD nScheme AS LONG lpszHostName AS WSTRINZ PTR dwHostNameLength AS DWORD nPort AS LONG lpszUserName AS WSTRINZ PTR dwUserNameLength AS DWORD lpszPassword AS WSTRINZ PTR dwPasswordLength AS DWORD lpszUrlPath AS WSTRINZ PTR dwUrlPathLength AS DWORD lpszExtraInfo AS WSTRINZ PTR dwExtraInfoLength AS DWORD END TYPE |
成员
dwStructSize
此结构的大小（以字节为单位）。用于版本检查。必须设置此结构的大小才能正确初始化此结构。
lpszSchemelb
指向包含方案名称的以null结尾的Unicode字符串。
dwSchemeLength
方案名称的长度，以字符为单位。
nScheme
互联网协议方案该成员可以是以下值之一。
值 |
含义 |
INTERNET_SCHEME_HTTP 1 |
互联网方案是HTTP协议。有关详细信息，请参阅RFC 2616. |
INTERNET_SCHEME_HTTPS 2 |
互联网方案HTTPS是使用安全事务语义的HTTP协议。 |
lpszHostName
指向包含主机名的以null结尾的Unicode字符串。
dwHostNameLength
主机名长度，以字符为单位。
nPort
端口号。
lpszUserName
指向包含用户名的以null结尾的Unicode字符串。
dwUserNameLength
用户名长度，以字符为单位。
lpszPassword
指向包含密码的以null结尾的Unicode字符串。
dwPasswordLength
密码长度，以字符为单位。
lpszUrlPath
指向包含URL路径的以null结尾的Unicode字符串。
dwUrlPathLength
URL路径的长度，以字符为单位。
lpszExtraInfo
指向包含额外信息的以null结尾的Unicode字符串值，例如？something或#something。
dwExtraInfoLength
无符号长整数值，包含多个信息的长度，宽字符。
备注
对于WinHttpCrackUrl函数，如果指针成员及其对应的长度成员都为零，则不返回URL的该组件。如果指针成员为NULL，但长度成员不为零，则返回指针和长度成员。如果指针和对应的长度成员都不为零，则指针成员指向复制组件的缓冲区。根据WinHttpCrackUrl的dwFlags中参数，可以从组件中删除所有转义序列。
对于WinHttpCreateUrl函数，如果不需要URL的组件，则指针成员应为NULL。如果对应的长度成员为零，则指针成员是指向零终止字符串的指针。如果长度成员不为零，则为相应指针成员的字符串长度。