Fungsi RtlUnicodeStringToUTF8String (wdm.h)

Fungsi RtlUnicodeStringToUTF8String mengonversi string sumber Unicode yang ditentukan menjadi string UTF8.

Sintaks

C++

NTSYSAPI NTSTATUS RtlUnicodeStringToUTF8String(
  PUTF8_STRING     DestinationString,
  PCUNICODE_STRING SourceString,
  BOOLEAN          AllocateDestinationString
);

Parameter

DestinationString

Penunjuk ke struktur UTF8_STRING untuk menahan string UTF8 yang dikonversi. Jika AllocateDestinationStringTRUE, rutinitas mengalokasikan buffer baru untuk menyimpan data string, dan memperbarui anggota BufferDestinationString untuk menunjuk ke buffer baru. Jika tidak, rutinitas menggunakan buffer yang saat ini ditentukan untuk menahan string. Bidang panjang maksimum hanya diatur jika AllocateDestinationString adalah TRUE.

SourceString

Penunjuk ke string sumber Unicode untuk dikonversi ke UTF8.

AllocateDestinationString

TRUE jika rutinitas ini adalah mengalokasikan ruang buffer untuk DestinationString. Jika ya, buffer harus dibatalkan alokasinya dengan memanggil RtlFreeUTF8String.

Mengembalikan nilai

Jika konversi berhasil, RtlUnicodeStringToUTF8String mengembalikan STATUS_SUCCESS. Jika gagal, rutinitas tidak mengalokasikan memori atau melakukan konversi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, version 2004
Header	wdm.h
IRQL	PASSIVE_LEVEL

Lihat juga

RtlFreeUTF8String