Fungsi RtlCopyUnicodeString (wdm.h)

  • Artikel

RtlCopyUnicodeString rutin menyalin string sumber ke string tujuan.

Sintaks

NTSYSAPI VOID RtlCopyUnicodeString(
  [in, out]      PUNICODE_STRING  DestinationString,
  [in, optional] PCUNICODE_STRING SourceString
);

Parameter

[in, out] DestinationString

Penunjuk ke buffer string tujuan. Parameter ini menunjuk ke struktur UNICODE_STRING .

[in, optional] SourceString

Penunjuk ke buffer string sumber. Parameter ini menunjuk ke struktur UNICODE_STRING .

Nilai kembali

Tidak ada

Keterangan

Jika SourceStringNULL, rutinitas ini mengatur bidang Panjang struktur yang ditujukkan oleh DestinationString ke nol.

Rutinitas ini tidak memodifikasi bidang MaximumLength dan Buffer dari struktur yang diacu oleh DestinationString.

Jumlah byte yang disalin dari string sumber adalah panjang string sumber (ditentukan oleh anggota Panjang struktur yang ditunjukkan oleh SourceString) atau panjang maksimum string tujuan (ditentukan oleh anggota MaximumLength dari struktur yang ditunjukkan oleh DestinationString), mana pun yang lebih kecil.

Pemanggil harus menginisialisasi semua anggota struktur yang diacu dengan benar oleh DestinationString sebelum memanggil RtlCopyUnicodeString. Kegagalan untuk menginisialisasi Panjang atau anggota MaximumLength sebelum memanggil rutinitas ini dapat menyebabkan buffer diserbu.

Buffer DestinationString dan SourceString harus residen jika pemanggil 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 Tingkat apa pun (Lihat bagian Keterangan)

Lihat juga

RtlCopyString

UNICODE_STRING