 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 function creates a URL from its component parts.
BOOL WINAPI InternetCreateUrl( LPURL_COMPONENTS lpUrlComponents , DWORD dwFlags , LPTSTR lpszUrl , LPDWORD lpdwUrlLength );
Parameters
- lpUrlComponents
- Long pointer to a URL_COMPONENTSstructure that contains the components from which to create the URL.
- dwFlags
- Specifies the operation of this function. It can be a
combination of these values:
Value Description ICU_ESCAPE Converts all escape sequences (%xx) to their corresponding characters. ICU_USERNAME When adding the user name, uses the name that was specified at logon time. - lpszUrl
- Long pointer to a buffer that receives the null-terminated string that contains the URL.
- lpdwUrlLength
- Long pointer to the length, in bytes, of the
lpszUrlbuffer. When the function returns, this parameter
receives the length, in bytes, of the URL string, minus 1 for the
terminating character. If
GetLastErrorreturns
ERROR_INSUFFICIENT_BUFFER, this parameter receives the number of
bytes required to hold the created URL.
Return Values
TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.
Windows CE Remarks
The lpdwUrlLengthparameter refers to the count of characters.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 2.0 and later Wininet.h Wininet.lib Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also