Fungsi RtlUnicodeStringToAnsiString (wdm.h)
Rutinitas RtlUnicodeStringToAnsiString mengonversi string Unicode tertentu menjadi string ANSI.
Sintaks
NTSYSAPI NTSTATUS RtlUnicodeStringToAnsiString(
[in, out] PANSI_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Parameter
[in, out] DestinationString
Arahkan 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
Arahkan ke string sumber Unicode untuk dikonversi ke ANSI.
[in] AllocateDestinationString
TRUE jika rutinitas ini adalah mengalokasikan ruang buffer untuk DestinationString. Jika ya, buffer harus dibatalkan alokasinya dengan memanggil RtlFreeAnsiString.
Nilai kembali
Jika konversi berhasil, RtlUnicodeStringToAnsiString mengembalikan STATUS_SUCCESS. Jika tidak, tidak ada penyimpanan yang dialokasikan, dan tidak ada konversi yang dilakukan.
Keterangan
Terjemahan dilakukan sesuai dengan informasi lokal sistem saat ini.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
| Target Platform | Universal |
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |