UrlGetLocationA.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

UrlGetLocationA (SHLWAPI.@)

SYNOPSIS

LPCSTR UrlGetLocationA
 (
  LPCSTR pszUrl
 )

DESCRIPTION

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

Defined in "shlwapi.h".

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

Debug channel "shell".