Fungsi RtlAnsiStringToUnicodeString (winternl.h)

Mengonversi string sumber ANSI yang ditentukan menjadi string Unicode.

Sintaks

NTSTATUS RtlAnsiStringToUnicodeString(
  [in, out] PUNICODE_STRING DestinationString,
  [in]      PCANSI_STRING   SourceString,
  [in]      BOOLEAN         AllocateDestinationString
);

Parameter

[in, out] DestinationString

Penunjuk ke struktur UNICODE_STRING untuk menahan string Unicode 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

Penunjuk ke struktur ANSI_STRING yang berisi string ANSI yang akan dikonversi ke Unicode.

[in] AllocateDestinationString

Mengontrol alokasi ruang buffer untuk string tujuan.

TRUE

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

FALSE

Ruang buffer tidak dialokasikan untuk DestinationString.

Nilai kembali

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

Menampilkan kode	Deskripsi
STATUS_SUCCESS	String ANSI dikonversi ke Unicode. Jika gagal, rutinitas tidak mengalokasikan memori apa pun.

Keterangan

Terjemahan dilakukan sehubungan dengan informasi lokal sistem saat ini.

Jika penelepon mengatur AllocateDestinationString ke TRUE, rutinitas mengganti anggota BufferDestinationString dengan penunjuk ke buffer yang dialokasikannya. Nilai lama dapat ditimpa bahkan ketika rutin mengembalikan kode status kesalahan.

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

Persyaratan

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