Fungsi RtlDowncaseUnicodeString (ntifs.h)

  • Artikel

Rutinitas RtlDowncaseUnicodeString mengonversi string sumber Unicode yang ditentukan menjadi huruf kecil. Terjemahan sesuai dengan informasi lokal sistem saat ini.

Sintaks

NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
       PUNICODE_STRING  DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parameter

DestinationString

Arahkan ke buffer yang dialokasikan penelepon untuk menerima string Unicode yang dikonversi. Jika AllocateDestinationStringFALSE, pemanggil juga harus mengalokasikan buffer untuk anggota BufferDestinationString untuk menyimpan data Unicode. Jika AllocateDestinationStringTRUE, RtlDowncaseUnicodeString mengalokasikan buffer yang cukup besar untuk menahan string, meneruskan penunjuk ke dalam Buffer, dan memperbarui panjang dan panjang maksimum anggota DestinationString yang sesuai.

[in] SourceString

Arahkan ke string Unicode sumber yang akan dikonversi menjadi huruf kecil.

[in] AllocateDestinationString

Atur ke TRUE jika RtlDowncaseUnicodeString harus mengalokasikan ruang buffer untuk DestinationString, FALSE sebaliknya. Jika parameter ini TRUE, pemanggil bertanggung jawab untuk membebaskan buffer ketika tidak lagi diperlukan dengan memanggil RtlFreeUnicodeString.

Nilai kembali

Jika operasi berhasil, RtlDowncaseUnicodeString mengembalikan STATUS_SUCCESS. Jika tidak, tidak ada penyimpanan yang dialokasikan dan tidak ada konversi yang dilakukan.

Keterangan

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

RtlDowncaseUnicodeString tidak mengubah string sumber.

Untuk informasi tentang rutinitas penanganan string lainnya, lihat Rutinitas Pustaka Run-Time (RTL).

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Lihat juga

RtlFreeUnicodeString

RtlUpcaseUnicodeString

UNICODE_STRING