Fonction StrCpyNW (shlwapi.h)

Article
08/08/2024

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

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

Syntaxe

PWSTR StrCpyNW(
  [out] PWSTR  pszDst,
  [in]  PCWSTR pszSrc,
        int    cchMax
);

Paramètres

[out] pszDst

Type : PTSTR

Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne correctement, reçoit la chaîne copiée. Cette mémoire tampon doit être de taille suffisante pour contenir les caractères copiés. Il n’est pas garanti que cette chaîne se termine par un caractère Null.

[in] pszSrc

Type : PCTSTR

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

cchMax

Type : int

Nombre de caractères à copier, y compris le caractère null de fin.

Valeur retournée

Type : PTSTR

Retourne un pointeur vers pszDst.

Remarques

Avertissement de sécurité : L’utilisation incorrecte de cette fonction peut compromettre la sécurité de votre application. Il n’est pas garanti que la chaîne copiée se termine par un caractère Null. Envisagez d’utiliser l’une des alternatives suivantes. StringCbCopy, StringCbCopyEx, StringCbCopyN, StringCbCopynEx, StringCchCopy, StringCchCopyEx, StringCchCopyN, StringCchCopyNEx. 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)

Partager via