This function creates a URL from its component parts.
At a Glance
Header file: | Wininet.h |
Windows CE versions: | 2.0 and later |
Syntax
BOOL WINAPI InternetCreateUrl(
LPURL_COMPONENTS lpUrlComponents, DWORD dwFlags,
LPTSTR lpszUrl, LPDWORD lpdwUrlLength);
Parameters
lpUrlComponents
Long pointer to a URL_COMPONENTS structure 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 lpszUrl buffer. When the function returns, this parameter receives the length, in bytes, of the URL string, minus 1 for the terminating character. If GetLastError returns 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 lpdwUrlLength parameter refers to the count of characters.