Fungsi WdmlibRtlInitUnicodeStringEx (wdmsec.h)
Fungsi WdmlibRtlInitUnicodeStringEx menginisialisasi string karakter Unicode yang dihitung.
Sintaks
NTSTATUS WdmlibRtlInitUnicodeStringEx(
[out] PUNICODE_STRING DestinationString,
[in, optional] PCWSTR SourceString
);
Parameter
[out] DestinationString
Penunjuk ke struktur UNICODE_STRING yang akan diinisialisasi.
[in, optional] SourceString
Penunjuk ke string karakter lebar yang dihentikan null. String ini digunakan untuk menginisialisasi string yang dihitung yang ditujukkan oleh DestinationString.
Nilai kembali
WdmlibRtlInitUnicodeStringEx mengembalikan STATUS_SUCCESS jika berhasil, jika tidak, metode dapat mengembalikan nilai NTSTATUS lainnya.
Keterangan
Rutin menyalin nilai penunjuk SourceString ke anggota Buffer dari struktur UNICODE_STRING yang ditujukkan oleh DestinationString. Anggota Panjang struktur ini diatur ke panjang, dalam byte, dari string sumber, tidak termasuk null yang mengakhiri. Anggota MaximumLength dari struktur diatur ke panjang, dalam byte, dari string sumber, termasuk null yang mengakhiri. Jika SourceStringNULL, Panjang dan MaximumLength keduanya diatur ke nol.
WdmlibRtlInitUnicodeStringEx tidak mengubah string sumber yang diacu oleh SourceString.
Catatan
Jika string sumber lebih panjang dari MAX_USTRING - 1 byte, WdmlibRtlInitUnicodeStringEx mengatur anggota Panjang struktur UNICODE_STRING yang ditunjukkan oleh DestinationString ke MAX_USTRING - 2, dan mengatur anggota MaximumLength dari struktur ini ke MAX_USTRING. Dalam hal ini, nilai Length dan MaximumLength salah menggambarkan panjang string sumber yang dihentikan null, dan mengandalkan akurasi nilai-nilai ini berpotensi berbahaya.
Pemanggil WdmlibRtlInitUnicodeStringEx dapat berjalan di IRQL <= DISPATCH_LEVEL jika buffer DestinationString tidak dapat diakses. Biasanya, penelepon berjalan di IRQL = PASSIVE_LEVEL karena sebagian besar rutinitas String RtlXxx lainnya tidak dapat dipanggil di IRQL > PASSIVE_LEVEL.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
Target Platform | Universal |
Header | wdmsec.h (termasuk Wdmsec.h, Wdm.h, Ntddk.h, Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | Lihat bagian Keterangan. |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk