 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This structure contains the constituent parts of a URL. This structure is used with the InternetCrackUrland InternetCreateUrlfunctions.
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_SCHEMEenumeration 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 InternetCrackUrlfunction, 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 dwFlagsparameter of the InternetCrackUrlfunction.
For the InternetCreateUrlfunction, 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