Fungsi RtlAppendUnicodeToString (wdm.h)

  • Artikel

Rutinitas RtlAppendUnicodeToString menggabungkan string Unicode yang disediakan ke string Unicode yang di-buffer.

Sintaks

NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
  [in, out]      PUNICODE_STRING Destination,
  [in, optional] PCWSTR          Source
);

Parameter

[in, out] Destination

Penunjuk ke string yang di-buffer.

[in, optional] Source

Penunjuk ke string yang dihentikan null untuk ditambahkan ke string Tujuan .

Nilai kembali

RtlAppendUnicodeToString dapat mengembalikan salah satu hal berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 String sumber berhasil ditambahkan ke string tujuan, dan panjang string tujuan diperbarui untuk menyertakan byte yang ditambahkan.
STATUS_BUFFER_TOO_SMALL
 Buffer string tujuan terlalu kecil untuk memungkinkan string sumber ditambahkan, sehingga panjang string tujuan tidak diperbarui dan konten buffer string tujuan tidak diubah.

Keterangan

RtlAppendUnicodeToString menambahkan string sumber ke akhir string tujuan.

Jika buffer tujuan tidak cukup besar untuk memuat string yang akan dihasilkan dari penggabungan string sumber dan tujuan (tidak termasuk karakter null yang mengakhiri string sumber), rutinitas mengembalikan STATUS_BUFFER_TOO_SMALL dan membiarkan string tujuan tidak berubah.

Buffer Tujuan harus bersifat residen jika penelepon berjalan di IRQL >= DISPATCH_LEVEL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe (mode kernel); Ntdll.dll (mode pengguna)
IRQL Lihat bagian Keterangan.

Lihat juga

RtlAppendUnicodeStringToString