CUrl::Canonicalize

Call this method to convert the URL string to canonical form.

inline BOOL Canonicalize( 
   DWORD dwFlags = 0  
) throw( );

Parameters

  • dwFlags
    The flags that control canonicalization. If no flags are specified (dwFlags = 0), the method converts all unsafe characters and meta sequences (such as \.,\ .., and \...) to escape sequences. dwFlags can be one of the following values:

    • ATL_URL_BROWSER_MODE: Does not encode or decode characters after "#" or "?" and does not remove trailing white space after "?". If this value is not specified, the entire URL is encoded and trailing white space is removed.

    • ATL_URL _DECODE: Converts all %XX sequences to characters, including escape sequences, before the URL is parsed.

    • ATL_URL _ENCODE_PERCENT: Encodes any percent signs encountered. By default, percent signs are not encoded.

    • ATL_URL _ENCODE_SPACES_ONLY: Encodes spaces only.

    • ATL_URL _NO_ENCODE: Does not convert unsafe characters to escape sequences.

    • ATL_URL _NO_META: Does not remove meta sequences (such as "." and "..") from the URL.

Return Value

Returns TRUE on success, FALSE on failure.

Remarks

Converting to canonical form involves converting unsafe characters and spaces to escape sequences.

Requirements

Header: atlutil.h

See Also

Reference

CUrl Class

Other Resources

CUrl Members