InternetCreateUrl (Windows Embedded CE 6.0)

1/6/2010

This function creates a URL from its component parts.

Syntax

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

Parameters

• 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.

Return Value

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

Remarks

The lpdwUrlLength parameter refers to the count of characters.

Requirements

See Also

Reference

WinInet Functions
URL_COMPONENTS