Edit

Share via

HttpPrepareUrl function (http.h)

  • Article

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