Fungsi RtlUnicodeStringToAnsiString (wdm.h)

  • Artikel

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

Lihat juga

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING