vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

Artikel
06/09/2015

Schreibt eine formatierte Ausgabe mithilfe eines Zeigers, der auf eine Liste von Argumenten zeigt. Diese Versionen von vprintf, _vprintf_l, vwprintf, _vwprintf_l enthalten Sicherheitserweiterungen wie unter Sicherheitsfunktionen in der CRT beschrieben.

int vprintf_s(
   const char *format,
   va_list argptr 
);
int _vprintf_s_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vwprintf_s(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_s_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parameter

format
Formatangabe.
argptr
Zeiger zur Liste der Argumente.
locale
Das zu verwendende Gebietsschema.

Weitere Informationen finden Sie unter Formatangaben.

Rückgabewert

vprintf_s und vwprintf_s geben die Anzahl der geschriebenen Zeichen ohne das abschließende Nullzeichen zurück oder einen negativen Wert, wenn ein Ausgabefehler auftritt. Wenn format ein NULL-Zeiger ist oder wenn Formatzeichenfolge ungültige Formatierungszeichen enthält, wird der Handler für ungültige Parameter aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben die Funktionen – 1 zurück und legen errno auf EINVAL fest.

Weitere Informationen über diese und andere Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Hinweise

Jede dieser Funktionen verwendet einen Zeiger auf eine Argumentliste und formatiert und schreibt anschließend die vorhandenen Daten in stdout.

Die sicheren Versionen dieser Funktionen unterscheiden sich von vprintf und vwprintf nur darin, dass die sicheren Versionen überprüfen, ob die Formatzeichenfolge gültige Formatierungszeichen enthält.

vwprintf_s ist die Breitzeichenversion von vprintf_s; die zwei Funktionen verhalten sich identisch, wenn der Stream im ANSI-Modus geöffnet ist. vprintf_s unterstützt derzeit die Ausgabe in einen UNICODE-Stream nicht.

Die Versionen dieser Funktionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch den ihnen übergebenen Gebietsschemaparameter anstelle des aktuellen Threadgebietsschemas.

Sicherheitshinweis
Stellen Sie sicher, dass format keine benutzerdefinierte Zeichenfolge ist.Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen.

Zuordnung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

Anforderungen

Routine	Erforderlicher Header	Optionale Header
vprintf_s, _vprintf_s_l	<stdio.h> und <stdarg.h>	<varargs.h>*
vwprintf_s, _vwprintf_s_l	<stdio.h> oder <wchar.h> und <stdarg.h>	<varargs.h>*

* Benötigt für die Kompatibilität mit UNIX V.

Die Konsole wird in Windows Store-Apps nicht unterstützt. Die mit der Konsole verknüpften Standardstreamhandles, stdin, stdout und stderr, müssen umgeleitet werden, bevor sie von C-Laufzeitfunktionen in Windows Store-Apps verwendet werden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.