InternetCreateUrl

A version of this page is also available for

4/8/2010

This function creates a URL from its component parts.

Syntax

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.

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

The lpdwUrlLength parameter refers to the count of characters.

Header	wininet.h
Library	wininet.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later