vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Článek
03/04/2013

Psát formátovaný výstup pomocí ukazatele na seznam argumentů.Tyto verze jsou vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l s vylepšení zabezpečení popsaným v Funkce zabezpečení v 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 
);

Parametry

stream
Ukazatel na FILE struktury.
format
Specifikace formátu.
argptr
Ukazatel na seznam argumentů.
locale
Národní prostředí použít.

Další informace naleznete v tématu Specifikace formátu.

Vrácená hodnota

vfprintf_sa vfwprintf_s vrácení počtu znaků písemné, není včetně ukončujícím znakem null nebo zápornou hodnotu, pokud dojde k chybě výstup.Pokud stream nebo format je ukazatel hodnotu null nebo pokud formátovací řetězec obsahuje neplatné formátování znaků, je vyvolána neplatný parametr popisovače, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, funkce vrátí -1 a errno na EINVAL.

Informace o těchto a jiných kódů chyb naleznete v tématu _doserrno, kód chyby, _sys_errlist a _sys_nerr.

Poznámky

Každá z těchto funkcí má ukazatel na seznam argumentů, pak formáty a zapíše do daného data stream.

Tyto funkce se liší od verze-secure pouze v tom, že zabezpečené verze zkontrolujte, zda format řetězec obsahuje platné znaky pro formátování.

vfwprintf_sje verze celého znaku vfprintf_s; dvě funkce chovat stejně, pokud datový proud je otevřen v režimu ANSI.vfprintf_snepodporuje aktuálně výstup do datového proudu UNICODE.

Verze těchto funkcí se _l přípony jsou shodné s výjimkou, že používají národní prostředí parametr předaný namísto aktuální podproces národní prostředí.

Poznámka k zabezpečení
Zajistit, aby format není uživatelem definovaný řetězec.Další informace naleznete v tématu Vyhnout způsobí přetečení vyrovnávací paměti.