fungsi wvnsprintfA (shlwapi.h)

  • Artikel

Mengambil daftar argumen dan mengembalikan nilai argumen sebagai string yang diformat gaya printf.

Catatan Jangan gunakan fungsi ini. Lihat Keterangan untuk fungsi alternatif.
 

Sintaks

int wvnsprintfA(
  [out] PSTR    pszDest,
  [in]  int     cchDest,
  [in]  PCSTR   pszFmt,
  [in]  va_list arglist
);

Parameter

[out] pszDest

Jenis: PTSTR

Penunjuk ke buffer yang, ketika fungsi ini berhasil dikembalikan, menerima string output.

[in] cchDest

Jenis: int

Jumlah maksimum karakter yang diizinkan dalam pszDest.

[in] pszFmt

Jenis: PCTSTR

String format gaya printf. Pengidentifikasi format %s tidak boleh digunakan dalam bentuk tak terbatas. Untuk menghindari potensi overrun buffer, selalu tentukan ukuran; misalnya "%32s".

[in] arglist

Jenis: va_list

Penunjuk ke daftar parameter baris perintah yang digunakan untuk menyesuaikan output.

Mengembalikan nilai

Jenis: int

Mengembalikan jumlah karakter yang ditulis ke buffer, tidak termasuk karakter NULL yang mengakhiri. Nilai negatif dikembalikan jika terjadi kesalahan.

Keterangan

Peringatan Keamanan: Menggunakan fungsi ini dengan tidak benar dapat membahayakan keamanan aplikasi Anda. String yang disalin tidak dijamin akan dihentikan null. Pertimbangkan untuk menggunakan salah satu alternatif berikut. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintf, StringCchPrintfEx, StringCchVPrintf, atau StringCchVPrintfEx. Anda harus meninjau Pertimbangan Keamanan: Microsoft Windows Shell sebelum melanjutkan.

Catatan

Header shlwapi.h mendefinisikan wvnsprintf sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header shlwapi.h
Pustaka Shlwapi.lib
DLL Shlwapi.dll (versi 5.0 atau yang lebih baru)