InternetCreateUrl

This function creates a URL from its component parts.

BOOL WINAPI InternetCreateUrl(
  LPURL_COMPONENTS lpUrlComponents, 
  DWORD dwFlags, 
  LPTSTR lpszUrl, 
  LPDWORD lpdwUrlLength 
);

lpUrlComponents
[in] Long pointer to a URL_COMPONENTS structure that contains the components from which to create the URL.
dwFlags
[in] Specifies the operation of this function. The following table shows the possible values. These values can be used in combination.

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
[out] Long pointer to a buffer that receives the null-terminated string that contains the URL.
lpdwUrlLength
[in, out] 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.

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.

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.

The lpdwUrlLength parameter refers to the count of characters.

OS Versions: Windows CE 2.0 and later.
Header: Wininet.h.
Link Library: Wininet.lib.

Additional resources