fungsi wnsprintfA (shlwapi.h)

Artikel
03/02/2024

Mengambil daftar argumen dengan panjang variabel dan mengembalikan nilai argumen sebagai string berformat gaya printf.

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

Sintaks

int wnsprintfA(
  [out] PSTR  pszDest,
  [in]  int   cchDest,
  [in]  PCSTR pszFmt,
        ...   
);

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".

...

Parameter tambahan yang berisi data yang akan menjadi 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.

Ini adalah versi Windows dari sprintf. Ini tidak mendukung jenis floating-point atau pointer. Ini hanya mendukung bendera perataan kiri.

Catatan

Header shlwapi.h mendefinisikan wnsprintf 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)

Bagikan melalui