vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Article
06/09/2015

Ecrit une sortie formattée en utilisant un pointeur vers une liste d'arguments. Il s'agit de versions de vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l avec des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité dans le CRT.

int vfprintf_s(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_s_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf_s(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_s_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Paramètres

stream
Pointeur vers la structure FILE.
format
Spécification de format.
argptr
Pointeur vers la liste d'arguments.
locale
Paramètres régionaux à utiliser.

Pour plus d'informations, consultez Spécifications de format.

Valeur de retour

vfprintf_s et vfwprintf_s renvoient le nombre de caractères écrits, sans le caractère null de fin, ou une valeur négative si une erreur de sortie se produit. Si soit stream est un pointeur null, soit format est un pointeur null, ou si le format de la chaine contient des caractères formant invalides, le gestionnaire de paramètres invalides est appelé comme décrit dansValidation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction renvoient -1 et définie errno avec la valeur EINVAL.

Pour plus d'informations sur ces codes d'erreur et autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.

Notes

Chacune de ces fonctions prend un pointeur vers une liste d'arguments, puis formate et écrit les données données dans stream.

Les versions sécurisées de ces fonctions diffèrent de leurs homologues non sécurisés seulement par le fait que les versions sécurisées vérifient que la chaine de format contient des caractères formant valides.

vfwprintf_s est la version à caractères élargis de vfprintf_s; les deux fonctions se comportent de la même manière si le flux est ouvert en mode ANSI. vfprintf_s ne prend pas en charge actuellement la sortie dans un flux UNICODE.

Les versions de ces fonctions avec le suffixe _l sont identiques, sauf qu'elles utilisent les paramètres régionaux passés au lieu des paramètres régionaux du thread actuel.

Note de sécurité
Assurez-vous que format n'est pas une chaîne définie par l'utilisateur.Pour plus d'informations, consultez Solutions contre les dépassements de mémoire tampon.