fungsi wvsprintfA (winuser.h)

Artikel
03/15/2023

Menulis data yang diformat ke buffer yang ditentukan menggunakan penunjuk ke daftar argumen. Item yang diacu oleh daftar argumen dikonversi dan disalin ke buffer output sesuai dengan spesifikasi format yang sesuai dalam string kontrol format. Fungsi menambahkan karakter null yang mengakhiri penghentian ke karakter yang ditulisnya, tetapi nilai yang dikembalikan tidak menyertakan karakter null yang mengakhiri dalam jumlah karakternya.

Peringatan Jangan gunakan. Pertimbangkan untuk menggunakan salah satu fungsi berikut sebagai gantinya: StringCbVPrintf, StringCbVPrintfEx, StringCchVPrintf, atau StringCchVPrintfEx. Lihat Pertimbangan Keamanan.

Sintaks

int wvsprintfA(
  [out] LPSTR   unnamedParam1,
  [in]  LPCSTR  unnamedParam2,
  [in]  va_list arglist
);

Parameter

[out] unnamedParam1

Jenis: LPTSTR

Buffer yang akan menerima output yang diformat. Ukuran maksimum buffer adalah 1.024 byte.

[in] unnamedParam2

Jenis: LPCTSTR

Spesifikasi kontrol format. Selain karakter ASCII biasa, spesifikasi format untuk setiap argumen muncul dalam string ini. Untuk informasi selengkapnya tentang spesifikasi format, lihat fungsi wsprintf .

[in] arglist

Jenis: va_list

Setiap elemen daftar ini menentukan argumen untuk string kontrol format. Angka, jenis, dan interpretasi argumen bergantung pada spesifikasi kontrol format yang sesuai dalam parameter lpFmt .

Nilai kembali

Jenis: int

Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah karakter yang disimpan dalam buffer, tidak menghitung karakter null yang mengakhiri.

Jika fungsi gagal, nilai pengembalian kurang dari panjang output yang diharapkan. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi menyalin string kontrol format ke dalam karakter buffer output berdasarkan karakter, dimulai dengan karakter pertama dalam string. Ketika menemukan spesifikasi format dalam string, fungsi mengambil nilai argumen berikutnya yang tersedia (dimulai dengan argumen pertama dalam daftar), mengonversi nilai tersebut ke dalam format yang ditentukan, dan menyalin hasilnya ke buffer output. Fungsi terus menyalin karakter dan memperluas spesifikasi format dengan cara ini hingga mencapai akhir string kontrol format. Jika ada lebih banyak argumen daripada spesifikasi format, argumen tambahan diabaikan. Jika tidak ada cukup argumen untuk semua spesifikasi format, hasilnya tidak ditentukan.

Catatan

Header winuser.h mendefinisikan wvsprintf 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


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll