_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l

Artículo
04/10/2013

Escriba el formato en la consola mediante un puntero a una lista de argumentos.Éstas son versiones de _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l con mejoras de seguridad como se describe en Características de seguridad en CRT.

Importante
Esta API no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /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
);

Parámetros

format
Especificación de formato.
argptr
Puntero a la lista de argumentos.
locale
La configuración regional a utilizar.

Para obtener más información, vea Especificaciones de formato.

Valor devuelto

El número de caracteres con tipo, o un valor negativo si un error de salida aparece.

Como la versión de que Secure de estas funciones, si format es un puntero NULL, el controlador no válido de parámetro se invoca, como se describe en Validación de parámetros.Además, a diferencia de la versión de que Secure de estas funciones, si format no especifica un formato válido, se genera una excepción no válida del parámetro.Si la ejecución puede continuar, estas funciones vuelven

Comentarios

Cada una de estas funciones contiene un puntero a una lista de argumentos, los formatos y escribe los datos especificados en la consola._vcwprintf_s constituye la versión con caracteres anchos de _vcprintf_s.Toma una cadena de caracteres como argumento.

Las versiones de estas funciones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en lugar de la configuración regional actual.

Nota sobre la seguridad
Asegúrese de que format no es una cadena definida por el usuario.Para obtener más información, vea Para evitar las saturaciones del búfer.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_vtcprintf_s	_vcprintf_s	_vcprintf_s	_vcwprintf_s
_vtcprintf_s_l	_vcprintf_s_l	_vcprintf_s_l	_vcwprintf_s_l

Requisitos

Rutina	Encabezado necesario	Encabezados opcionales
_vcprintf_s, _vcprintf_s_l	<conio.h> y <stdarg.h>	<varargs.h>*
_vcwprintf_s, _vcwprintf_s_l	<conio.h> o <wchar.h>, y <stdarg.h>	<varargs.h>*

* Necesario para la compatibilidad de UNIX V.

Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.

Ejemplo

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