UrlGetLocationA(3w)

UrlGetLocationA3w

Usage

LPCSTR UrlGetLocationA
(
LPCSTR pszUrl
)

Overview

Get the location from a Url.

Params

pszUrl [In] Url to get the location from.

Returns

A pointer to the start of the location in pszUrl, or NULL if there is no location.

Notes

- MSDN erroneously states that "The location is the segment of the Url starting with a '?' or '#' character". Neither V4 nor V5 of shlwapi.dll stop at '?' and always return a NULL in this case.

- MSDN also erroneously states that "If a file Url has a query string, the returned string is the query string". In all tested cases, if the Url starts with "fi" then a NULL is returned. V5 gives the following results:

Result Url

------ ---

NULL file://aa/b/cd#hohoh

#hohoh http://aa/b/cd#hohoh

NULL fi://aa/b/cd#hohoh

#hohoh ff://aa/b/cd#hohoh

Implementation

Declared in "shlwapi.h".

Implemented in "dlls/shlwapi/url.c".

Debug channel "shell".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.