Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

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

Feedback

Was this page helpful?

Additional resources

  • Last updated on