Fonction StrCatW (shlwapi.h)

Ajoute une chaîne à une autre.

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

 

Syntaxe

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

Paramètres

[in, out] psz1

Type : PTSTR

Pointeur vers une chaîne terminée par null. Lorsque cette fonction retourne correctement, cette chaîne contient son contenu d’origine avec la chaîne psz2 ajoutée. Cette mémoire tampon doit être suffisamment grande pour contenir les deux chaînes et le caractère null de fin.

[in] psz2

Type : PCTSTR

Pointeur vers une chaîne terminée par null à ajouter à psz1.

Valeur retournée

Type : PTSTR

Retourne un pointeur vers psz1, qui contient les chaînes combinées.

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 : StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCatEx, StringCchCatEx, StringCchCatN ou StringCchCatNEx. Vous devez consulter considérations relatives à la sécurité : Microsoft Windows Shell avant de continuer.

Configuration requise

Condition requise	Valeur
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)