.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH UrlGetLocationA 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBUrlGetLocationA\fR (SHLWAPI.@)
.SH SYNOPSIS
LPCSTR UrlGetLocationA
 (
  LPCSTR \fIpszUrl\fR
 )

.SH DESCRIPTION
.PP
Get the location from a Url. 

.SH PARAMS
\fIpszUrl\fR \fB[In]\fR  Url to get the location from.
.PP

.SH RETURNS
.PP
A pointer to the start of the location in \fIpszUrl\fR, or \fBNULL\fR if there is no location. 

.SH NOTES
.PP
\fB-\fR \fBMSDN\fR erroneously states that "The location is the segment of the Url starting with a \fB'?'\fR or \fB'#'\fR character". Neither \fBV4\fR nor \fBV5\fR of shlwapi.dll stop at \fB'?'\fR and always return a \fBNULL\fR in this case. 
.PP
\fB-\fR \fBMSDN\fR 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 \fB"fi"\fR then a \fBNULL\fR is returned. \fBV5\fR gives the following results: 
.br
       Result   Url
.br
       ------   ---
.br
       NULL     file://aa/b/cd#hohoh
.br
       #hohoh   http://aa/b/cd#hohoh
.br
       NULL     fi://aa/b/cd#hohoh
.br
       #hohoh   ff://aa/b/cd#hohoh

.SH IMPLEMENTATION
.PP
Declared in \fB"shlwapi.h"\fR. 
.PP
Implemented in \fB"dlls/shlwapi/url.c"\fR. 
.PP
Debug channel \fB"shell"\fR.