Fungsi RtlUnicodeStringToAnsiString (winternl.h)

Artikel
03/04/2024

Mengonversi string sumber Unicode yang ditentukan menjadi string ANSI.

Sintaks

NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Parameter

[in, out] DestinationString

Penunjuk ke struktur ANSI_STRING untuk menahan string ANSI 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.

[in] SourceString

Struktur UNICODE_STRING yang berisi string sumber yang akan dikonversi ke ANSI.

[in] AllocateDestinationString

Mengontrol alokasi ruang buffer untuk DestinationString.

TRUE

Ruang buffer dialokasikan untuk DestinationString. Jika diatur ke TRUE, buffer harus dibatalkan alokasinya menggunakan RtlFreeAnsiString.

FALSE

Ruang buffer tidak dialokasikan untuk DestinationString.

Mengembalikan nilai

Berbagai nilai NTSTATUS didefinisikan dalam NTSTATUS. H, yang didistribusikan dengan DDK.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	String Unicode dikonversi ke ANSI. Jika tidak, tidak ada penyimpanan yang dialokasikan dan tidak ada konversi yang dilakukan.

Keterangan

Terjemahan dilakukan sehubungan dengan informasi lokal sistem saat ini.

Karena tidak ada pustaka impor untuk fungsi ini, Anda harus menggunakan GetProcAddress.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winternl.h
Pustaka	ntdll.lib
DLL	ntdll.dll; NtosKrnl.exe

Bagikan melalui