memcpy_s, wmemcpy_s

Kopiert Bytes zwischen Puffern. Diese Funktionen sind Versionen von memcpy, wmemcpy mit Sicherheitsverbesserungen, wie in sicherheitsfeatures im CRT beschrieben.

Syntax

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

Parameter

dest
Neuer Puffer.

destSize
Größe des Zielpuffers in Bytes für memcpy_s und breite Zeichen (wchar_t) für wmemcpy_s.

src
Der Puffer, aus dem kopiert werden soll.

count
Anzahl der zu kopierenden Zeichen.

Rückgabewert

Null, wenn erfolgreich, ein Fehlercode, wenn ein Fehler auftritt.

Fehlerbedingungen

dest	destSize	src	count	Rückgabewert	Inhalt von dest
Beliebig	Beliebig	Beliebig	0	0	Not modified (Nicht geändert)
NULL	Beliebig	Beliebig	ungleich null	EINVAL	Not modified (Nicht geändert)
Beliebig	Beliebig	NULL	ungleich null	EINVAL	dest wird auf null gesetzt
Beliebig	< count	Beliebig	ungleich null	ERANGE	dest wird auf null gesetzt

Hinweise

memcpy_skopiert Bytes von src in dest; wmemcpy_s kopiert countcount breite Zeichen. Wenn sich die Quell- und Zielbereiche überlappen, wird das Verhalten nicht memcpy_s definiert. Verwendung memmove_s um überlappende Bereiche zu behandeln.

Diese Funktionen überprüfen ihre Parameter. Wenn count es sich nicht um Null und dest oder src um einen Nullzeiger handelt oder destSize kleiner als countist, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, werden diese Funktionen zurückgegeben EINVAL oder ERANGEauf den Rückgabewert festgelegt errno .

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

Routine	Erforderlicher Header
memcpy_s	<memory.h> oder <string.h>
wmemcpy_s	<wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

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

0 1 4 9 16 25 36 49 64 81

Siehe auch

Puffermanipulation
_memccpy
memchr, wmemchr
memcmp, wmemcmp
memmove, wmemmove
memset, wmemset
strcpy, wcscpy, _mbscpy
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
strncpy_s, _strncpy_s_l, wcsncpy_s, _wcsncpy_s_l, _mbsncpy_s, _mbsncpy_s_l