Export (0) Print
Expand All
div
eof
Expand Minimize
This topic has not yet been rated - Rate this topic

_mbccpy, _mbccpy_l 

Copy a multibyte character from one string to another string. These functions are deprecated because more secure versions are available; see _mbccpy_s, _mbccpy_s_l.


void _mbccpy(
   unsigned char *dest,
   const unsigned char *src 
);
void _mbccpy_l(
   unsigned char *dest,
   const unsigned char *src,
   _locale_t locale
);

Parameters

dest

Copy destination.

src

Multibyte character to copy.

locale

Locale to use.

The _mbccpy function copies one multibyte character from src to dest.

This function validates its parameters. If _mbccpy is passed a null pointer for dest or src, the invalid parameter handler is invoked, as described in Parameter Validation. If execution is allowed to continue, errno is set to EINVAL.

_mbccpy uses the current locale for any locale-dependent behavior. _mbccpy_l is identical to _mbccpy except that _mbccpy_l uses the locale passed in for any locale-dependent behavior.

Security Note   Use a null-terminated string. The null-terminated string must not exceed the size of the destination buffer. For more information, see Avoiding Buffer Overruns. Buffer overrun problems are a frequent method of system attack, resulting in an unwarranted elevation of privilege.

Generic-Text Routine Mappings
Tchar.h routine _UNICODE and _MBCS not defined _MBCS defined _UNICODE defined

_tccpy

Maps to macro or inline function

_mbccpy

Maps to macro or inline function

_tccpy_l

n/a

_mbccpy_l

n/a

Routine Required header Compatibility

_mbccpy

<mbctype.h>

Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

_mbccpy_l

<mbctype.h>

Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

For more compatibility information, see Compatibility in the Introduction.

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.