Fungsi RtlInitUTF8StringEx (wdm.h)
Rutinitas RtlInitUTF8StringEx menginisialisasi string karakter UTF-8 yang dihitung.
Sintaks
NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
PUTF8_STRING DestinationString,
__drv_aliasesMem PCSZ SourceString
);
Parameter
DestinationString
Penunjuk ke struktur UTF8_STRING yang akan diinisialisasi. File header Ntdef.h mendefinisikan struktur ini agar identik dengan struktur STRING .
SourceString
Penunjuk ke string karakter yang dihentikan null. String ini digunakan untuk menginisialisasi string yang dihitung yang ditujukkan oleh DestinationString.
Nilai kembali
Mengembalikan STATUS_NAME_TOO_LONG jika SourceString terlalu panjang. Jika tidak, rutinitas ini mengembalikan STATUS_SUCCESS.
Keterangan
Rutin menyalin nilai penunjuk SourceString ke anggota Buffer dari struktur UTF8_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.
RtlInitUTF8StringEx tidak mengubah string sumber yang diacu oleh SourceString.
Pemanggil RtlInitUTF8StringEx dapat berjalan di IRQL <= DISPATCH_LEVEL jika buffer DestinationString tidak dapat dihapus. 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 | Windows 10, version 2004 |
Header | wdm.h |
IRQL | <= DISPATCH_LEVEL |
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