vprintf_s， _vprintf_s_l， vwprintf_s， _vwprintf_s_l

编写格式化输出使用指针参数列表。 这些是 vprintf， _vprintf_l， vwprintf， _vwprintf_l 的版本与安全增强如 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 
);

参数

• format
  格式规范。

• argptr
  列表的指针参数。

• locale
  使用的区域设置。

有关更多信息，请参见 格式规范。

返回值

如果输出错误，vprintf_s 和 vwprintf_s 返回编写的字符数，不包括终止 null 字符) 或负值。 如果 format 是 null 指针，或者，如果格式字符串包含无效格式字符，无效参数调用处理程序，如 参数验证所述。 如果执行允许继续，函数返回 -1 并将 errno 到 EINVAL。

有关这些属性和其他错误代码的信息，请参见 _doserrno、errno、_sys_errlist 和_sys_nerr。

备注

这些功能中的每一个采用指向参数列表，然后布局和编写特定数据。stdout。

这些函数的安全版本与 vprintf 和 vwprintf 只是在于安全版本检查格式字符串包含格式无效字符。

vwprintf_s 是 vprintf_s的宽字符版本；，如果流在 ANSI 模式下，中打开两个函数具有相同的行为。 vprintf_s 当前不支持输出到 UNICODE 流。

这些功能的版本与 _l 后缀的相同，只不过它们使用区域设置参数而不是当前线程区域设置。

安全说明
确保 format 不是用户定义的字符串。有关更多信息，请参见 避免缓冲区溢出。

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

要求

实例	必需的标头	选项标头
vprintf_s, _vprintf_s_l	<stdio.h> 和 <stdarg.h>	<varargs.h>*
vwprintf_s, _vwprintf_s_l	<stdio.h> 或 <wchar.h>和 <stdarg.h>	<varargs.h>*

*仅对 UNIX v 兼容性。

控件个在 Windows 应用商店 apps 不受支持。 标准流处理与控件个，stdin，stdout和 stderr，在 C 运行时函数在 Windows 应用商店 apps 之前，可以使用它们必须重定向。 有关其他的兼容性信息，请参见中介绍的 兼容性。

.NET Framework 等效项

System::Console::Write

请参见

参考

流I/O

vprintf功能

fprintf， _fprintf_l， fwprintf， _fwprintf_l

printf， _printf_l， wprintf， _wprintf_l

sprintf， _sprintf_l， swprintf， _swprintf_l， __swprintf_l

va_arg， va_end， va_start