Share via

EscapeXML

  • Article

 

Call this function to convert characters that are unsafe for use in XML to their safe equivalents.

Syntax

      inline int EscapeXML(
   const wchar_t * szIn,
   int nSrcLen,
   wchar_t * szEsc,
   int nDestLen,
   DWORD dwFlags = ATL_ESC_FLAG_NONE 
) throw( );

Parameters

  • szIn
    The string to be converted.

  • nSrclen
    The length in characters of the string to be converted.

  • szEsc
    Caller-allocated buffer to receive the converted string.

  • nDestLen
    The length in characters of the caller-allocated buffer.

  • dwFlags
    Flags describing how the conversion is to be performed. See ATL_ESC Flags.

Return Value

The length in characters of the converted string.

Remarks

Possible conversions performed by this function are shown in the table:

Source

Destination

<

&lt;

>

&gt;

&

&amp;

'

&apos;

"

&quot;

Requirements

Header: atlenc.h

See Also

Active Template Library (ATL) Concepts
ATL COM Desktop Components
ATL Functions Alphabetical Reference