Partager via

Fonction StrCatChainW (shlwapi.h)

  • Article

Concatène deux chaînes Unicode. Utilisé lorsque des concaténations répétées vers la même mémoire tampon sont requises.

Syntaxe

DWORD StrCatChainW(
  [out] PWSTR  pszDst,
        DWORD  cchDst,
        DWORD  ichAt,
  [in]  PCWSTR pszSrc
);

Paramètres

[out] pszDst

Type : PWSTR

Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne correctement, reçoit la chaîne Unicode terminée par null.

cchDst

Type : DWORD

Taille de la mémoire tampon de destination, en caractères. Cette mémoire tampon doit avoir une taille suffisante pour contenir les deux chaînes ainsi qu’un caractère null de fin. Si la mémoire tampon est trop petite, la chaîne finale est tronquée.

ichAt

Type : DWORD

Décalage dans la mémoire tampon de destination à laquelle commencer l’action d’ajout. Si la chaîne n’est pas vide, définissez cette valeur sur -1 pour que le nombre actuel de caractères remplis (sans le caractère null de fin) soit calculé pour vous.

[in] pszSrc

Type : PCWSTR

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

Valeur retournée

Type : DWORD

Retourne le décalage du caractère null après le dernier caractère ajouté à 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 finale se termine par null. Envisagez d’utiliser l’une des alternatives suivantes : StringCbCatEx, StringCbCatNEx, StringCchCatEx 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 XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlwapi.h
Bibliothèque Shlwapi.lib
DLL Shlwapi.dll (version 5.5 ou ultérieure)