vfprintf_s、_vfprintf_s_l、vfwprintf_s、_vfwprintf_s_l

使用指向一個引數清單的指標輸出格式化的字串 這些是 vfprintf、_vfprintf_l、vfwprintf、_vfwprintf_l 的安全性增強版本，如 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 
);

參數

• stream
  指向 FILE 結構的指標。

• format
  格式規範。

• argptr
  參數清單的指標。

• locale
  要使用的地區設定。

如需詳細資訊，請參閱格式規格。

傳回值

vfprintf_s 和 vfwprintf_s 回傳寫入的字元數，不包含結尾的空字元，或者在輸出發生錯誤時回傳一個負值。 如果 stream 或 format 為 null 指標，或是如果格式字串包含無效的格式化字元，無效的參數會叫用處理常式，如 參數驗證 中所述。 如果允許繼續執行，函式回傳 -1 並將 errno 設置為 EINVAL 。

如需有關這些錯誤碼和其他錯誤碼的詳細資訊，請參閱 _doserrno、errno、_sys_errlist 和 _sys_nerr。

備註

這些函式都接受指標引數清單，然後格式和寫入 stream的特定資料。

這些函式與非安全版本的不同處只在於安全版本檢查 format 字串包含有效格式字元。

vfwprintf_s 是 vfprintf_s的寬字元版本;如果資料流在 ANSI 模式中開啟，則兩個函式的作用完全相同。 vfprintf_s 目前不支援輸出到 UNICODE 串流。

這些有 _l 尾碼的函式版本是一樣的，不同之處在於會使用傳入的地區設定，而不使用目前的執行緒地區設定。

安全性提示
確認 format 不是使用者定義的字串。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

一般文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 已定義	_UNICODE 已定義
_vftprintf_s	vfprintf_s	vfprintf_s	vfwprintf_s
_vftprintf_s_l	_vfprintf_s_l	_vfprintf_s_l	_vfwprintf_s_l

需求

常式	必要的標頭	選擇性的標頭檔
vfprintf_s, _vfprintf_s_l	<stdio.h> 和 <stdarg.h>	<varargs.h>*
vfwprintf_s, _vfwprintf_s_l	<stdio.h> 或 <wchar.h>, 及 <stdarg.h>	<varargs.h>*

* 要求 UNIX V 相容性。

如需其他相容性資訊，請參閱＜簡介＞中的相容性。

.NET Framework 對等用法

不適用。若要呼叫標準 C 函式，請使用 PInvoke。如需詳細資訊，請參閱平台叫用範例。

請參閱

參考

資料流 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_copy、va_end、va_start