Fonction StrCatW (shlwapi.h)

Ajoute une chaîne à une autre.

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