Fungsi RtlDowncaseUnicodeString (ntifs.h)
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 |