vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

Articolo
03/26/2013

Scrivere l'output formattato utilizzando un puntatore a un elenco di argomenti.Queste sono versioni di vprintf, _vprintf_l, vwprintf, _vwprintf_l con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

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 
);

Parametri

format
Specifica di formato,
argptr
Puntatore all'elenco di argomenti.
locale
Le impostazioni locali da utilizzare.

Per ulteriori informazioni, vedere Specifiche di formato.

Valore restituito

vprintf_s e vwprintf_s restituiscono il numero di caratteri scritti, escluso il carattere di terminazione null, o un valore negativo se un errore di output viene visualizzato.Se format è un puntatore null, o se la stringa di formato contiene caratteri di formattazione non validi, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno a EINVAL.

Per ulteriori informazioni su questi, e altri, codici di errore vedere _doserrno, errno, _sys_errlist, and _sys_nerr .

Note

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, quindi i formati e scrive i dati specificati a stdout.

Le versioni sicure di queste funzioni differiscono solo da vprintf e da vwprintf in quanto le versioni sicure che controllano la stringa di formato contengono i caratteri di formattazione validi.

vwprintf_s è la versione a caratteri estesi di vprintf_s; le due funzioni si comportano in modo identico se il flusso viene aperto in modalità ANSI.vprintf_s non supporta attualmente l'output in un flusso UNICODE.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione che utilizzano il parametro delle impostazioni locali passato in ingresso invece di utilizzare quelle del thread corrente.

Nota sulla sicurezza
Assicurarsi che format non sia una stringa definita dall'utente.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

Requisiti

Routine	Intestazione obbligatoria	Intestazioni facoltative
vprintf_s, _vprintf_s_l	<stdio.h> e <stdarg.h>	<varargs.h>*
vwprintf_s, _vwprintf_s_l	<stdio.h> o <wchar.h> e <stdarg.h>	<varargs.h>*

* Necessario per la compatibilità con UNIX V.

La console non è supportata nelle applicazioni di Windows Store.L'handle standard del flusso associate alla console, stdin, stdoute stderr, devono essere reindirizzati prima di funzioni di runtime del linguaggio C possono essere utilizzate nelle applicazioni di Windows Store.Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.