vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

Makale
03/27/2013

Bağımsız değişkenler listesi için bir işaretçi kullanarak biçimlendirilmiş çıktı yazma.Sürümleri bunlar vprintf, _vprintf_l, vwprintf, _vwprintf_l açıklandığı gibi güvenlik geliştirmeleri ile crt güvenlik özellikleri.

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

Parametreler

format
Biçim belirtimi.
argptr
Bağımsız değişkenler listesi için işaretçi.
locale
Kullanılacak yerel ayarı.

Daha fazla bilgi için bkz: Biçimi belirtimleri.

Dönüş Değeri

vprintf_sve vwprintf_s çıktı hatası oluşursa, sondaki boş karakter ya da negatif bir değer dahil edilmez yazılan karakterlerin sayısını döndürür.format Null bir işaretçidir veya biçim dizesi geçersiz biçimlendirme karakterlerini içeriyorsa, geçersiz bir parametre işleyicisi, açıklandığı gibi çağrılır Parametre doğrulama.Yürütülmesine devam etmek için izin verilirse, işlevler -1 döndürür ve errno için EINVAL.

Bunlar ve diğer hata kodları hakkında daha fazla bilgi için bkz: _doserrno, hatano, _sys_errlist ve _sys_nerr.

Notlar

Bu işlevlerden her biri için bir bağımsız değişken listesi bir işaretçi alır sonra biçimlendirir ve verilen verileri Yazar stdout.

Bu işlevlerin güvenli sürümlerini farklı vprintf ve vwprintf , yalnızca güvenli sürümlerini biçim dizesi geçerli biçimlendirme karakterleri içerip içermediğini denetleyin.

vwprintf_sgeniş karakter sürümü vprintf_s; iki işlev akış ANSI modunda açılırsa aynı şekilde davranır.vprintf_sşu anda çıktı UNICODE akımına desteklemiyor.

Bu işlevleri sürümlerini _l sonek dışında geçerli iş parçacığı yerel geçirilen yerel ayar parametresi kullandıkları aynı.

Güvenlik Notu
Emin format kullanıcı tanımlı bir dize değil.Daha fazla bilgi için bkz: Kaçınma arabelleğin taşmasına neden.

Genel metin eşlemeleri yordamına girildi

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

Gereksinimler

Yordamı	Gerekli başlık	İsteğe bağlı üstbilgi
vprintf_s, _vprintf_s_l	<stdio.h> ve <stdarg.h>	<varargs.h> *
vwprintf_s, _vwprintf_s_l	<stdio.h> veya <wchar.h> ve <stdarg.h>	<varargs.h> *

* UNIX v uyumluluk için gereklidir.

Konsol desteklenen değil Windows Mağazası apps.Konsolu ile ilgili standart akış tanıtıcıları stdin, stdout, ve stderr, c çalışma zamanı işlevlerini de kullanılmadan önce yönlendirilecek Windows Mağazası apps.Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.