wvnsprintfA, fonction (shlwapi.h)

Article
11/20/2024

Prend une liste d’arguments et retourne les valeurs des arguments sous la forme d’une printf-style chaîne mise en forme.

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

Syntaxe

int wvnsprintfA(
  [out] PSTR    pszDest,
  [in]  int     cchDest,
  [in]  PCSTR   pszFmt,
  [in]  va_list arglist
);

Paramètres

[out] pszDest

Type : PTSTR

Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne correctement, reçoit la chaîne de sortie.

[in] cchDest

Type : int

Nombre maximal de caractères autorisés dans pszDest.

[in] pszFmt

Type : PCTSTR

Chaîne de format printf-style. L’identificateur de format %s ne doit jamais être utilisé dans un formulaire non lié. Pour éviter les dépassements potentiels de mémoire tampon, spécifiez toujours une taille ; par exemple «%32s».

[in] arglist

Type : va_list

Pointeur vers une liste de paramètres de ligne de commande utilisés pour personnaliser la sortie.

Valeur de retour

Type : int

Retourne le nombre de caractères écrits dans la mémoire tampon, à l’exclusion de toute fin caractères NULL caractères. Une valeur négative est retournée si une erreur se produit.

Remarques

Avertissement de sécurité : L’utilisation de cette fonction peut compromettre la sécurité de votre application. La chaîne copiée n’est pas garantie d’être terminée par null. Envisagez d’utiliser l’une des alternatives suivantes. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, String StringStringCchPrintf , StringCchPrintfEx, StringCchVPrintfou StringCchVPrintfEx. 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 wvnsprintf 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 5.0 ou ultérieure)

Partager via