HttpPrepareUrl function

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 WINAPI HttpPrepareUrl(
  _Reserved_ PVOID  Reserved,
  _Reserved_ ULONG  Flags,
  _In_       PCWSTR Url,
  _Out_      PWSTR  *PreparedUrl
);

Parameters

Reserved

Reserved. Must be NULL.

Flags

Reserved. Must be zero.

Url [in]

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

PreparedUrl [out]

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