CoInternetParseUrl

This function parses URLs. This is a helper API.

STDAPI CoInternetParseUrl(
  LPCWSTR pwzUrl,
  PARSEACTION ParseAction,
  DWORD dwFlags,
  LPWSTR pszResult,
  DWORD cchResult,
  DWORD* pcchResult,
  DWORD dwReserved
);

Parameters

pwzUrl

String value that contains the URL to parse.

ParseAction

ParseAction value that determines the information to be parsed from the URL.

dwFlags

Unsigned long integer value that controls the parsing operation, based on the value passed as the ParseAction parameter.

pszResult

String value that contains the information parsed from the URL.

cchResult

Unsigned long integer value that contains the size of the buffer.

pcchResult

Address of an unsigned long integer value that contains the size of the information stored in the buffer.

dwReserved

Reserved. Must be set to zero.

Return Values

Returns one of the values shown in the following table.

Value	Description
S_OK	Success.
S_FALSE	The buffer was too small to contain the resulting URL.
INET_E_DEFAULT_ACTION	Use the default action.

Remarks

If PARSE_CANONICALIZE was passed as the ParseAction parameter, the flags valid for the dwFlags parameter of UrlCanonicalize can be passed to the dwFlags parameter of CoInternetParseUrl to control the parsing operation.

If PARSE_UNESCAPE or PARSE_ENCODE was passed as the ParseAction parameter, the flags valid for the dwFlags parameter of UrlUnescape can be passed to the dwFlags parameter of CoInternetParseUrl to control the parsing operation.

If PARSE_ESCAPE or PARSE_DECODE was passed as the ParseAction parameter, the flags valid for the dwFlags parameter of UrlEscape can be passed to the dwFlags parameter of CoInternetParseUrl to control the parsing operation.

If PARSE_PATH_FROM_URL was passed as the ParseAction parameter, the flags valid for the dwFlags parameter of PathCreateFromUrl can be passed to the dwFlags parameter of CoInternetParseUrl to control the parsing operation.

If PARSE_URL_FROM_PATH was passed as the ParseAction parameter, the flags valid for the dwFlags parameter of UrlCreateFromPath can be passed to the dwFlags parameter of CoInternetParseUrl to control the parsing operation.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Urlmon.h, Urlmon.idl.
Link Library: Urlmon.lib.