Fungsi RtlInitUTF8StringEx (ntifs.h)

Artikel
08/07/2023

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 ANSI_STRING .

SourceString

Penunjuk ke string karakter yang dihentikan null. SourceString digunakan untuk menginisialisasi string terhitung yang dituju DestinationString .

Nilai kembali

RtlInitUTF8StringEx mengembalikan STATUS_NAME_TOO_LONG jika SourceString terlalu panjang. Jika tidak, rutinitas ini mengembalikan STATUS_SUCCESS.

Keterangan

RtlInitUTF8StringEx menetapkan anggota struktur UTF8_STRING yang dituju destinationstring sebagai berikut:

Menyalin nilai pointer SourceString ke anggota Buffer .
Mengatur anggota Panjang ke panjang, dalam byte, dari string sumber, tidak termasuk null yang mengakhiri.
Mengatur anggota MaximumLength ke panjang, dalam byte, dari string sumber, termasuk null yang mengakhiri.

Jika SourceStringNULL, Panjang dan MaximumLength keduanya diatur ke nol.

RtlInitStringEx tidak mengubah string sumber yang diacu oleh SourceString.

Pemanggil RtlInitStringEx 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	Windows 10, version 2004
Header	ntifs.h

Lihat juga

ANSI_STRING

Bagikan melalui