memcpy_s, wmemcpy_s

Статья
02/20/2013

Копирует байты между буферами.Эти версии memcpy, wmemcpy со службами расширений безопасности, как описано в разделе Средства безопасности в CRT.

errno_t memcpy_s(
   void *dest,
   size_t numberOfElements,
   const void *src,
   size_t count 
);
errno_t wmemcpy_s(
   wchar_t *dest,
   size_t numberOfElements,
   const wchar_t *src,
   size_t count
);

Параметры

dest
Новый буфер.
numberOfElements
Размер буфера назначения.
src
Буфер, из которого выполняется копирование.
count
Число копируемых знаков.

Возвращаемое значение

Нуль, если выполнение прошло успешно; код ошибки при сбое.

Условия возникновения ошибок

dest	numberOfElements	src	Возвращаемое значение	Содержимое dest
NULL	any	any	EINVAL	не было
any	any	NULL	EINVAL	dest обнулит
any	< count	any	ERANGE	dest обнулит

Заметки

memcpy_s копии count байты из src В dest; wmemcpy_s копии count расширенные символы (2 байта).Если источник и назначение перекрываются, то применяются расширения функциональности memcpy_s препроцессора.Используйте memmove_s обрабатывать перекрывающиеся области.

Эти функции проверяют их параметры.If dest OR src указатель null или numberOfElements слишком малы для буфера, вызывающие эти функции недопустимы обработчик параметра, как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то эти функции возвращают EINVAL и errno В EINVAL.

Требования

Процедура	Обязательный заголовок
memcpy_s	<memory.h> OR <string.h>
wmemcpy_s	<wchar.h>

Дополнительные сведения о совместимости см. Совместимость во введении.

Пример

// crt_memcpy_s.c
// Copy memory in a more secure way.

#include <memory.h>
#include <stdio.h>

int main()
{
   int a1[10], a2[100], i;
   errno_t err;

   // Populate a2 with squares of integers
   for (i = 0; i < 100; i++)
   {
      a2[i] = i*i;
   }

   // Tell memcpy_s to copy 10 ints (40 bytes), giving
   // the size of the a1 array (also 40 bytes).
   err = memcpy_s(a1, sizeof(a1), a2, 10 * sizeof (int) );    
   if (err)
   {
      printf("Error executing memcpy_s.\n");
   }
   else
   {
     for (i = 0; i < 10; i++)
       printf("%d ", a1[i]);
   }
   printf("\n");
}