Metode CHString::FormatMessageW(UINT,...) (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(
  UINT nFormatID,
  ...  
);

Parameter

nFormatID

Pengidentifikasi sumber daya string yang berisi teks pesan yang tidak diformat.

...

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 deskripsi urutan escape ini dan maknanya, lihat topik fungsi Windows FormatMessage .

Catatan Untuk mengurangi paparan serangan 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