wnsprintfW, fonction (shlwapi.h)

Article
11/20/2024

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

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

Syntaxe

int wnsprintfW(
  [out] PWSTR  pszDest,
  [in]  int    cchDest,
  [in]  PCWSTR pszFmt,
        ...    
);

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».

...

Paramètres supplémentaires qui contiennent les données à générer.

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.

Il s’agit d’une version Windows de sprintf. Il ne prend pas en charge les types à virgule flottante ou pointeur. Il prend uniquement en charge l’indicateur d’alignement gauche.

Note

L’en-tête shlwapi.h définit wnsprintf 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