memcpy_s, wmemcpy_s

Articolo
06/09/2015

Copia i byte tra i buffer. Queste sono versioni di memcpy, wmemcpy con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in 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
);

Parametri

dest
Nuovo buffer.
numberOfElements
Dimensione del buffer di destinazione.
src
Buffer da cui copiare.
count
Numero di caratteri da copiare.

Valore restituito

Zero se ha esito positivo; un codice di errore in caso di errore.

Condizioni di errore

dest	numberOfElements	src	Valore restituito	Contenuto di dest.
NULL	any	any	EINVAL	non modificato
any	any	NULL	EINVAL	dest è impostato su zero
any	< count	any	ERANGE	dest è impostato su zero

Note

memcpy_s copia i byte di count da src a dest; wmemcpy_s copia i caratteri wide di count (byte). Se le aree di origine e di destinazione si sovrappongono, il comportamento di memcpy_s non è definito. Utilizza memmove_s per gestire le aree di sovrapposizione.

Queste funzioni convalidano i parametri. Se dest o src è un puntatore null, o numberOfElements è troppo piccolo per il buffer, queste funzioni invocano il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono EINVAL e impostano errno su EINVAL.

Requisiti

Routine	Intestazione obbligatoria
memcpy_s	<memory.h> o <string.h>
wmemcpy_s	<wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.

Esempio

// 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");
}