HttpPrepareUrl function (http.h)

The HttpPrepareUrl function parses, analyzes, and normalizes a non-normalized Unicode or punycode URL so it is safe and valid to use in other HTTP functions.

Syntax

HTTPAPI_LINKAGE ULONG HttpPrepareUrl(
        PVOID  Reserved,
        ULONG  Flags,
  [in]  PCWSTR Url,
  [out] PWSTR  *PreparedUrl
);

Parameters

Reserved

Reserved. Must be NULL.

Flags

Reserved. Must be zero.

[in] Url

A pointer to a string that represents the non-normalized Unicode or punycode URL to prepare.

[out] PreparedUrl

On successful output, a pointer to a string that represents the normalized URL.

Note  Free PreparedUrl using HeapFree.

 

Return value

If the function succeeds, it returns ERROR_SUCCESS.

If the function fails, it returns one of the following or a system error code defined in WinError.h.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Target Platform	Windows
Header	http.h
Library	Httpapi.lib
DLL	Httpapi.dll