Fungsi RtlFindUnicodePrefix (ntifs.h)
Rutinitas RtlFindUnicodePrefix mencari kecocokan terbaik untuk nama file Unicode tertentu dalam tabel awalan.
Sintaks
NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlFindUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] PCUNICODE_STRING FullName,
[in] ULONG CaseInsensitiveIndex
);
Parameter
[in] PrefixTable
Penunjuk ke tabel awalan. Tabel harus diinisialisasi dengan memanggil RtlInitializeUnicodePrefix.
[in] FullName
Penunjuk ke string Unicode yang berisi nama jalur lengkap untuk file.
[in] CaseInsensitiveIndex
Posisi dalam nama file dan string awalan di mana perbandingannya adalah menjadi tidak peka huruf besar/kecil. Perbandingan string peka huruf besar/kecil untuk karakter CaseInsensitiveIndex pertama di setiap string, tidak peka huruf besar/kecil untuk sisa string.
| Nilai | Makna |
|---|---|
| 0 | Perbandingan string tidak peka huruf besar/kecil. |
| 1..FullName.Length-1 | Perbandingan string peka huruf besar/kecil untuk karakter pada posisi 0 hingga CaseInsensitiveIndex-1, tidak peka huruf besar/kecil untuk karakter dari posisi CaseInsensitiveIndex hingga akhir string. |
| FullName.Length | Perbandingan string peka huruf besar/kecil. |
Mengembalikan nilai
RtlFindUnicodePrefix mengembalikan penunjuk ke awalan terpanjang yang tepat yang ditemukan untuk string yang diberikan di FullName. Jika tidak ada awalan yang cocok yang ditemukan, RtlFindUnicodePrefix mengembalikan NULL.
Keterangan
Setiap entri awalan dalam tabel adalah nama jalur yang relatif terhadap direktori akar volume sistem file. Agar terbentuk dengan baik, awalan harus dimulai dengan satu garis miring terbalik ().
Ketika menemukan awalan yang cocok, RtlFindUnicodePrefix menyeimbangkan kembali pohon splay tabel awalan.
Sistem file harus memanggil RtlInitializeUnicodePrefix untuk menginisialisasi tabel awalan sebelum menggunakan Rtl lainnya. Rutinitas UnicodePrefix di atasnya. Struktur tabel awalan yang diinisialisasi harus dianggap buram.
Penelepon Rtl.. Rutinitas UnicodePrefix bertanggung jawab untuk menyinkronkan akses ke tabel awalan. Mutex cepat adalah mekanisme sinkronisasi yang paling efisien untuk digunakan untuk tujuan ini.
Untuk informasi tentang rutinitas penanganan string lainnya, lihat Rutinitas Pustaka Run-Time (RTL).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP |
| Server minimum yang didukung | Windows Server 2003 |
| Target Platform | Universal |
| Header | ntifs.h (termasuk Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |