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

.SH NAME
\fBUrlCanonicalizeA\fR (SHLWAPI.@)
.SH SYNOPSIS
HRESULT UrlCanonicalizeA
 (
  LPCSTR  \fIpszUrl\fR,
  LPSTR   \fIpszCanonicalized\fR,
  LPDWORD \fIpcchCanonicalized\fR,
  DWORD   \fIdwFlags\fR
 )

.SH DESCRIPTION
.PP
Canonicalize a Url. 

.SH PARAMS
\fIpszUrl\fR \fB[In]\fR  Url to cCanonicalize.
.PP
\fIpszCanonicalized\fR \fB[Out]\fR  Destination for converted Url.
.PP
\fIpcchCanonicalized\fR \fB[In/Out]\fR  Length of \fIpszUrl\fR, destination for length of \fIpszCanonicalized\fR.
.PP
\fIdwFlags\fR \fB[In]\fR  Flags controlling the conversion.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fBS_OK\fR. The \fIpszCanonicalized\fR contains the converted Url. 
.PP
\fBFailure:\fR \fBE_POINTER\fR, if *\fIpcchCanonicalized\fR is too small. 
.PP
\fBMSDN\fR incorrectly describes the flags for this function. They should be: 
.br
    URL_DONT_ESCAPE_EXTRA_INFO    0x02000000
.br
    URL_ESCAPE_SPACES_ONLY        0x04000000
.br
    URL_ESCAPE_PERCENT            0x00001000
.br
    URL_ESCAPE_UNSAFE             0x10000000
.br
    URL_UNESCAPE                  0x10000000
.br
    URL_DONT_SIMPLIFY             0x08000000
.br
    URL_ESCAPE_SEGMENT_ONLY       0x00002000

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