Fonction StrCpyW (shlwapi.h)

Copie une chaîne dans une autre.

Syntaxe

PWSTR StrCpyW(
  [out] PWSTR  psz1,
  [in]  PCWSTR psz2
);

Paramètres

[out] psz1

Type : PTSTR

Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne correctement, reçoit la chaîne copiée. Cette chaîne n’est pas garantie pour être terminée par null.

[in] psz2

Type : PCTSTR

Pointeur vers la chaîne source terminée par null.

Valeur retournée

Type : PTSTR

Retourne un pointeur vers psz1.

Remarques

Avertissement de sécurité : L’utilisation incorrecte de cette fonction peut compromettre la sécurité de votre application. Le premier argument, psz1, doit être suffisamment grand pour contenir psz2 et la fermeture « \0 », sinon un dépassement de mémoire tampon peut se produire. Les dépassements de mémoire tampon peuvent entraîner une attaque par déni de service contre l’application en cas de violation d’accès. Dans le pire des cas, un dépassement de mémoire tampon peut permettre à un attaquant d’injecter du code exécutable dans votre processus, en particulier si psz1 est une mémoire tampon basée sur la pile. Envisagez d’utiliser l’une des alternatives suivantes : StringCbCopy, StringCbCopyEx, StringCbCopyN, StringCbCopyNEx, StringCchCopyEx, StringCchCopyEx, StringCchCopyN ou StringCchCopyNEx. Vous devez consulter considérations relatives à la sécurité : Microsoft Windows Shell avant de continuer.

Configuration requise