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