fungsi wnsprintfW (shlwapi.h)

Artikel
20/11/2024

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

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

Sintaksis

C++

int wnsprintfW(
  [out] PWSTR  pszDest,
  [in]  int    cchDest,
  [in]  PCWSTR 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 formatcetak . Pengidentifikasi format %s tidak boleh digunakan dalam bentuk yang tidak terbatas. Untuk menghindari potensi overruns buffer, selalu tentukan ukuran; misalnya "%32s".

...

Parameter tambahan yang berisi data yang akan dihasilkan.

Mengembalikan nilai

Jenis: int

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

Komentar

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 Windows darisprintf . 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 preprosedur 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

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

Bagikan melalui