vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

Artigo
02/25/2013

Gravar saída formatados usando um ponteiro para uma lista de argumentos.Essas são versões de vprintf, _vprintf_l, vwprintf, _vwprintf_l com aprimoramentos de segurança conforme descrito em Recursos de segurança no 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 );

Parâmetros

format
Formatar a especificação.
argptr
Ponteiro para a lista de argumentos.
locale
A localidade a ser usada.

Para obter mais informações, consulte Especificações de formato.

Valor de retorno

vprintf_s e vwprintf_s retorna o número de caracteres gravados, não incluindo o caractere de terminação zero, ou um valor negativo se ocorrer um erro de saída.Se format é um ponteiro zero, ou se a cadeia de caracteres de formato de formatação contém caracteres inválidos, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, funções e retornam -1 errno definido como EINVAL.

Para obter informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist, e _sys_nerr.

Comentários

Cada uma dessas funções tem um ponteiro para um lista de argumentos, então os formatos e grava dados para os dados a stdout.

As versões seguros dessas funções diferem de vprintf e de vwprintf apenas as versões seguros verifica a cadeia de caracteres de formato contém caracteres de formatação válidos.

vwprintf_s é a versão do largo- caractere de vprintf_s; as duas funções se comportam de forma idêntica se o fluxo é aberta no modo ANSI.vprintf_s não tem suporte para a saída em um fluxo de UNICODE.

As versões dessas funções com o sufixo de _l são idênticas exceto que usam o parâmetro de localidade passado em vez de localidade atual da thread.

Observação de segurança
Certifique-se de que format não é uma cadeia de caracteres definida pelo usuário.Para obter mais informações, consulte Evitando estouros de buffer.

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H	_UNICODE & _MBCS não definidos	_MBCS definido	_UNICODE definido
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

Requisitos

Rotina	Cabeçalho necessário	Cabeçalhos opcionais
vprintf_s, _vprintf_s_l	<stdio.h> e <stdarg.h>	<varargs.h>*
vwprintf_s, _vwprintf_s_l	<stdio.h> ou <wchar.h>, e <stdarg.h>	<varargs.h>*

* Necessário para a compatibilidade de UNIX V.

O console não é suportado em aplicativos de Windows Store .Identificadores padrões de fluxo associadas ao console, stdin, stdout, e stderr, devem ser redirecionada antes que as funções de tempo de execução das C pode usar em aplicativos de Windows Store .Para informações extras de compatibilidade Compatibilidade na introdução, consulte.