Share via


InternetCreateUrl

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 
);

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

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

See Also

Reference

URL_COMPONENTS
WinInet Functions