URL_COMPONENTS
This structure contains the constituent parts of a URL. This structure is used with the InternetCrackUrl and InternetCreateUrl functions.
typedef struct {
DWORD dwStructSize;
LPTSTR lpszScheme;
DWORD dwSchemeLength;
INTERNET_SCHEME nScheme;
LPTSTR lpszHostName;
DWORD dwHostNameLength;
INTERNET_PORT nPort;
LPTSTR lpszUserName;
DWORD dwUserNameLength;
LPTSTR lpszPassword;
DWORD dwPasswordLength;
LPTSTR lpszUrlPath;
DWORD dwUrlPathLength;
LPTSTR lpszExtraInfo;
DWORD dwExtraInfoLength;
} URL_COMPONENTS, *LPURL_COMPONENTS;
Members
- dwStructSize
Unsigned long integer value that contains the size, in TCHAR, of this structure and is used for version checking. The size of this structure must be set to initialize this structure properly. - lpszScheme
Address of a string value that contains the scheme name. - dwSchemeLength
Unsigned long integer value that contains the length of the scheme name in TCHAR. - nScheme
INTERNET_SCHEME enumeration that indicates the Internet protocol scheme. - lpszHostName
Address of a string value that contains the host name. - dwHostNameLength
Unsigned long integer value that contains the length of the host name in TCHAR. - nPort
Converted port number. - lpszUserName
Address of a string value that contains the user name. - dwUserNameLength
Unsigned long integer value that contains the length of the user name in TCHAR. - lpszPassword
Address of a string value that contains the password. - dwPasswordLength
Unsigned long integer value that contains the length of the password in TCHAR. - lpszUrlPath
Address of a string value that contains the URL path. - dwUrlPathLength
Unsigned long integer value that contains the length of the URL path in TCHAR. - lpszExtraInfo
Address of a string value that contains the extra information (for example, ?something or #something). - dwExtraInfoLength
Unsigned long integer value that contains the length of the extra information in TCHAR.
Remarks
For the InternetCrackUrl function, if a pointer member and its corresponding length member are both zero, that component is not returned. If the pointer member is NULL but the length member is not zero, both the pointer and length members are returned. If both pointer and corresponding length members are nonzero, the pointer member points to a buffer where the component is copied. The component can be unescaped, depending on the dwFlags parameter of the InternetCrackUrl function.
For the InternetCreateUrl function, the pointer members should be NULL if the component is not required. If the corresponding length member is zero, the pointer member is the address of a zero-terminated string. If the length member is not zero, it is the string length of the corresponding pointer member.
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.12 and later | Wininet.h | Wininet.lib |
See Also
InternetCrackUrl, InternetCreateUrl, INTERNET_SCHEME
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.