vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Artykuł
06/09/2015

Zapis sformatowane dane wyjściowe przy użyciu wskaźnika do listy argumentów.Są to wersje vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l z rozszerzeń zabezpieczeń opisane w Funkcje zabezpieczeń w 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
Wskaźnik, aby FILE struktury.
format
Specyfikacja formatu.
argptr
Wskaźnik do listy argumentów.
locale
Ustawienia regionalne, aby użyć.

Aby uzyskać więcej informacji, zobacz Specyfikacji formatu.

Wartość zwracana

vfprintf_si vfwprintf_s zwraca liczbę znaków, napisane, nie włączając kończącego znaku null lub wartości ujemne, jeśli wystąpi błąd danych wyjściowych.Jeśli albo stream lub format jest wskaźnik zerowy lub jeśli ciąg formatu zawiera nieprawidłowe znaki formatowania, nieprawidłowy parametr wywoływana jest funkcja obsługi, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje zwracają wartość -1 i errno do EINVAL.

Informacji na temat tych i innych kodów błędów, zobacz _doserrno, errno, _sys_errlist i _sys_nerr.

Uwagi

Każda z tych funkcji ma wskaźnik do listy argumentów, a następnie formatuje i zapisuje dostarczone dane do stream.

Funkcje te różnią się od wersji-secure tylko w tym bezpiecznej wersji Sprawdź, czy format ciąg zawiera prawidłowe znaki formatowania.

vfwprintf_sWersja szerokich znaków jest vfprintf_s; dwie funkcje zachowują się identycznie, gdy strumień jest otwierany w trybie ANSI.vfprintf_saktualnie nie obsługuje dane wyjściowe do strumienia UNICODE.

Wersje te funkcje, z _l sufiks są identyczne, z wyjątkiem, że używają oni przekazany zamiast bieżące ustawienia regionalne wątku parametr ustawień regionalnych.