Fonction StrCpyW (shlwapi.h)

  • Article

Copie une chaîne dans une autre.

Note N’utilisez pas. Consultez Remarques pour les fonctions alternatives.
 

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

   
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlwapi.h
Bibliothèque Shlwapi.lib
DLL Shlwapi.dll (version 4.71 ou ultérieure)