_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l

Artikel
03/12/2013

Write formatierte Ausgabe an die Konsole mithilfe eines Zeigers auf eine Liste der Argumente.Diese sind Versionen von _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l mit Sicherheitserweiterungen, wie in Sicherheitsfeatures im CRT beschrieben.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

int _vcprintf( const char* format, va_list argptr ); int _vcprintf( const char* format, locale_t locale, va_list argptr ); int _vcwprintf_s( const wchar_t* format, va_list argptr ); int _vcwprintf_s_l( const wchar_t* format, locale_t locale, va_list argptr );

Parameter

format
Formatangabe.
argptr
Zeiger auf die Liste der Argumente.
locale
Das Gebietsschema zu verwenden.

Weitere Informationen finden Sie unter Formatangaben.

Rückgabewert

Die Anzahl der Zeichen geschrieben oder ein negativer Wert, wenn ein Ausgabefehler auftritt.

Wie die nicht sichere Version dieser Funktionen, wenn format ein NULL-Zeiger ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Außerdem als die nicht sichere Version dieser Funktionen, wenn format kein gültiges Format angibt, wird eine ungültige Parameterausnahme generiert.Wenn die Ausführung zulässig ist, um fortzufahren, geben diese Funktionen zurück

Hinweise

Jede dieser Funktionen verwendet einen Zeiger auf eine Argumentliste, dann Stilen und schreibt die angegebenen Daten an die Konsole aus._vcwprintf_s ist die Breitzeichen-Version von _vcprintf_s.Sie nimmt eine Zeichenfolge mit Breitzeichen als Argument.

Die Versionen dieser Funktionen mit dem _l Suffix sind identisch, allerdings verwenden den Gebietsschemaparameter in, der anstelle des aktuellen Gebietsschemas übergeben wird.

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

Zuordnung generische Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert.	_MBCS definiert	_UNICODE definiert
_vtcprintf_s	_vcprintf_s	_vcprintf_s	_vcwprintf_s
_vtcprintf_s_l	_vcprintf_s_l	_vcprintf_s_l	_vcwprintf_s_l

Anforderungen

Routine	Erforderlicher Header	Optionale Header
_vcprintf_s, _vcprintf_s_l	<conio.h> und <stdarg.h>	<varargs.h>*
_vcwprintf_s, _vcwprintf_s_l	<conio.h> oder <wchar.h>und <stdarg.h>	<varargs.h>*

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

So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

// crt_vcprintf_s.cpp
#include <conio.h>
#include <stdarg.h>

// An error formatting function used to print to the console.
int eprintf_s(const char* format, ...)
{
  va_list args;
  va_start(args, format);
  return _vcprintf_s(format, args);
}

int main()
{
   eprintf_s("  (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
           "<some error text>");
   eprintf_s("  (Related to symbol '%s' defined on line %d).\n",
           "<symbol>", 5 );
}