_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l

아티클
04/10/2013

형식이 지정 된 출력 인수 목록에 대한 포인터를 사용 하 여 콘솔에 씁니다.이러한 버전의 수 _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l 에 설명 된 대로 보안 향상 기능을 CRT의 보안 기능.

중요
이 API는 Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 CRT 함수.

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

매개 변수

format
형식 사양입니다.
argptr
인수 목록에 대한 포인터입니다.
locale
사용 하는 로캘.

자세한 내용은 형식 사양을.

반환 값

쓴 문자 수 또는 출력 오류가 발생 하는 경우 음수 값입니다.

원하는 경우 이러한 함수의 안전 하지 않은 버전 format 는 null 포인터에 설명 된 대로 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사.이러한 함수의 안전 하지 않은 버전 또한 달리 경우 format 올바른 형식으로 지정 하지 않는 잘못 된 매개 변수가 예외가 생성 됩니다.이러한 함수는 실행을 계속 하도록 허용 된 경우, 반환

설명

이러한 각 함수는 인수 목록에 대한 포인터를 사용 하 고 서식과 주어진된 데이터를 콘솔에 씁니다._vcwprintf_s와이드 문자 버전인 _vcprintf_s.이 와이드 문자 문자열을 인수로 사용 합니다.

이러한 함수 버전의 _l 접미사는 현재 로캘 대신 전달 된 로캘 매개 변수를 사용 하는 경우를 제외 하 고 동일 합니다.

보안 정보
되도록 format 사용자 정의 하는 문자열이 아닙니다.자세한 내용은 버퍼 오버런 방지.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되어 있지 않습니다	_Mbcs가 정의	_Unicode가 정의
_vtcprintf_s	_vcprintf_s	_vcprintf_s	_vcwprintf_s
_vtcprintf_s_l	_vcprintf_s_l	_vcprintf_s_l	_vcwprintf_s_l

요구 사항

루틴	필수 헤더	선택적 헤더
_vcprintf_s, _vcprintf_s_l	<conio.h> 및 <stdarg.h>	<varargs.h> *
_vcwprintf_s, _vcwprintf_s_l	<conio.h> 또는 <wchar.h> 및 <stdarg.h>	<varargs.h> *

* UNIX V 호환성을 위해 필요합니다.

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

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