vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l

Artigo
08/25/2010

gravar formatado usando um ponteiro para uma lista de argumentos de saída.Essas são sistema autônomo versões de vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no 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 
);

Parâmetros

stream
Ponteiro para FILE estrutura.
format
Especificação de formato.
argptr
Ponteiro para a lista de argumentos.
locale
A localidade para usar.

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

Valor de retorno

vfprintf_s e vfwprintf_s Retorna o número de caracteres escritos, não incluindo o caractere nulo de terminação ou um valor negativo se ocorrer um erro de saída. Se qualquer um dos stream ou format é um ponteiro nulo ou se a seqüência de caracteres de formato contém caracteres inválidos de formatação, o manipulador de parâmetro inválido é chamado, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, as funções retornam -1 e conjunto errno para EINVAL.

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

Comentários

Cada uma dessas funções leva um ponteiro para uma lista de argumentos, em seguida, formata e grava os dados fornecidos stream.

Essas funções diferem das versões não seguras apenas de versões seguras Verifique se o format a seqüência de caracteres contém formatação de caracteres válida.

vfwprintf_s é a versão de caractere largo da vfprintf_s; as duas funções tenham comportamento idêntico se o fluxo é aberto no modo ANSI. vfprintf_s atualmente não suporta saída em um fluxo UNICODE.

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

Observação de segurança:
Certifique-se de que format não é uma seqüência de caracteres definida pelo usuário. Para obter mais informações, consulte Evitar saturações de buffer.