Fonction StrNCatA (shlwapi.h)

Article
08/26/2023

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

Note N’utilisez pas cette fonction ou la macro StrCatN . Consultez Remarques pour les fonctions alternatives.

Syntaxe

PSTR StrNCatA(
  [in, out] PSTR  psz1,
            PCSTR 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 plus 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 retournée

Type : PTSTR

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

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

Notes

L’en-tête shlwapi.h définit StrNCat en tant qu’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. La combinaison 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.

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)

Partager via