fungsi wnsprintfW (shlwapi.h)

Artikel
03/02/2024

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

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

Sintaks

int wnsprintfW(
  [out] PWSTR  pszDest,
  [in]  int    cchDest,
  [in]  PCWSTR pszFmt,
        ...    
);

Parameter

[out] pszDest

Jenis: PTSTR

Penunjuk ke buffer yang, ketika fungsi ini berhasil kembali, 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 yang tidak terikat. Untuk menghindari potensi buffer overruns, selalu tentukan ukuran; misalnya "%32s".

...

Parameter tambahan yang berisi data yang akan menjadi output.

Nilai kembali

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 salah dapat membahayakan keamanan aplikasi Anda. String yang disalin tidak dijamin null-dihentikan. 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 sprintf Windows. 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