CHString::FormatMessageW(LPCWSTR,...) metode (chstring.h)

[Kelas CHString adalah bagian dari Kerangka Kerja Penyedia WMI yang sekarang dipertimbangkan dalam keadaan akhir, dan tidak ada pengembangan, peningkatan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]

Metode FormatMessageW memformat string pesan.

Sintaks

void  throw(CHeap_Exception) FormatMessageW(
  LPCWSTR lpszFormat,
  ...     
);

Parameter

lpszFormat

Penunjuk ke string kontrol formal. String kontrol dipindai untuk sisipan dan diformat dengan sesuai. String format mirip dengan fungsi runtime, string format gaya printf, kecuali cetakan memungkinkan parameter dimasukkan dalam urutan arbitrer.

...

Daftar argumen.

Menampilkan nilai

CHeap_Exception

Keterangan

Metode FormatMessageW memerlukan definisi pesan sebagai input. Definisi pesan ditentukan oleh lpszFormat, atau dari sumber daya string yang diidentifikasi oleh nFormatID. Metode menyalin teks pesan yang diformat ke string CHString , memproses urutan sisipan yang disematkan jika diminta.

Setiap sisipan harus memiliki parameter yang sesuai yang mengikuti parameter lpszFormat atau nFormatID . Dalam teks pesan, beberapa urutan escape didukung untuk memformat pesan secara dinamis. Untuk informasi selengkapnya dan deskripsi urutan escape ini dan maknanya, lihat topik fungsi FormatMessage .

Catatan Untuk mengurangi kerentanan keamanan, selalu gunakan string format untuk FormatMessageW. Misalnya, FormatMessageW(input) dapat dieksploitasi, dan FormatMessageW("%s", input) tidak. Jangan pernah menggunakan string yang disediakan pengguna untuk string format. Jika string format Anda disimpan untuk tujuan seperti pelokalan, pastikan string dilindungi dari akses tulis yang tidak sah. Jika fungsi Anda menulis ke string daripada output standar, Anda mungkin perlu menghindari penggunaan trailing "%s" dalam string format.

Contoh

Contoh kode berikut menunjukkan cara menggunakan CHString::FormatMessageW.

CHString str;
int nAsked = 5;
int nAgree = 4;

str.FormatMessageW(L"%1!d! of %2!d! developers agree: Golf is %3%!", 
                   nAgree, nAsked, L"Best");
assert(str == L"4 of 5 developers agree: Golf is Best!");

Persyaratan

Persyaratan	Nilai
Header	chstring.h

Lihat juga

CHString

CHString::Format