vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

Makale
06/09/2015

Bağımsız değişkenler listesine bir işaretçi kullanarak biçimlendirilmiş çıktı yazar.Bu vprintf, _vprintf_l, vwprintf, _vwprintf_l sürümlerinde CRT'deki Güvenlik Özellikleri içinde açıklandığı gibi güvenlik geliştirmeleri mevcut olabilir.

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 listesine işaretçi.
locale
Kullanılacak yerel ayar.

Daha fazla bilgi için bkz. Biçim Belirtimleri.

Dönüş Değeri

vprintf_s ve vwprintf_s sondaki null karakter dışında, harici bir hata oluştuğunda negatif bir değeri veya yazılmış karakterlerin sayısını döndürür.formatbir null işaretçiyse veya biçim dizesi geçersiz biçimlendirme karakterleri içeriyorsa, geçersiz parametre işleyicisi Parametre Doğrulama konusunda açıklanan şekilde çağrılır.Yürütmenin devam etmesine izin verilirse, işlevler -1 döndürür ve errno öğesini EINVAL olarak ayarlar.

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

Notlar

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

Bu işlevlerin güvenli sürümleri vprintf ile vwprintf'ten farklıdır, sadece güvenli sürümler biçim dizesinin geçerli düzenleme karakterleri içerip içermediğini kontrol eder.

vwprintf_svprintf_s öğesinin geniş karakterli sürümüdür; akış ANSI modunda açılırsa iki işlev aynı şekilde davranır.vprintf_s şu anda UNICODE akışına çıkış alınmasını desteklemez.

_l sonekine sahip bu işlevlerin sürümleri, geçerli iş parçacığı yerel ayarı yerine iletilen yerel ayar parametresini kullanmalarıdır.

Güvenlik Notu
format öğesinin bir kullanıcı tanımlı dize olmadığından emin olun.Daha fazla bilgi için, bkz. Arabellek Taşmalarını Önleme.

Genel Metin Yordam Eşleşmeleri

TCHAR.H yordamı	_UNICODE & _MBCS tanımlanmamış	_MBCS tanımlanmış	_UNICODE tanımlanmış
_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ı üst bilgiler
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 uyumluluğu için gerekli.

Konsol Windows Mağazası uygulamalarında desteklenmiyor.stdin, stdout ve stderr konsolları ile ilişkili standart akış işleyicileri, C çalışma zamanı işlevleri bunları Windows Mağazası uygulamalarında kullanmadan önce yeniden yönlendirilmelidir.Ek uyumluluk bilgileri için bkz. Uyumluluk.