StrNCatW, fonction (shlwapi.h)

Article
11/20/2024

Ajoute un nombre spécifié de caractères du début d’une chaîne à la fin d’une autre.

Remarque N’utilisez pas cette fonction ou la macro StrCatN. Consultez les remarques relatives à d’autres fonctions.

Syntaxe

PWSTR StrNCatW(
  [in, out] PWSTR  psz1,
            PCWSTR psz2,
            int    cchMax
);

Paramètres

[in, out] psz1

Type : PTSTR

Pointeur vers une chaîne terminée par null à laquelle la fonction ajoute les caractères de psz2. Il doit être suffisamment grand pour contenir les chaînes combinées ainsi que le caractère null de fin.

psz2

Type : PCTSTR

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

cchMax

Type : int

Nombre de caractères à ajouter à psz1 à partir du début de psz2.

Valeur de retour

Type : PTSTR

Retourne un pointeur vers psz1, qui contient la chaîne combinée.

Remarques

Avertissement de sécurité : L’utilisation 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 si une violation d’accès se produit. 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. N’oubliez pas que le dernier argument, cchMax, est le nombre de caractères à copier dans psz1, pas nécessairement la taille du psz1 en octets. Envisagez d’utiliser l’une des alternatives suivantes. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatNou StringCchCatNEx. Vous devez passer en revue considérations relatives à la sécurité : Microsoft Windows Shell avant de continuer.

Note

L’en-tête shlwapi.h définit StrNCat comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via