Fungsi RtlIsNameLegalDOS8Dot3 (ntifs.h)
Rutinitas RtlIsNameLegalDOS8Dot3 menentukan apakah nama tertentu mewakili nama file pendek (8,3) yang valid.
Sintaks
NTSYSAPI BOOLEAN RtlIsNameLegalDOS8Dot3(
[in] PCUNICODE_STRING Name,
[in, out] POEM_STRING OemName,
[out, optional] PBOOLEAN NameContainsSpaces
);
Parameter
[in] Name
Penunjuk ke string Unicode yang berisi nama file.
[in, out] OemName
Penunjuk ke buffer yang dialokasikan pemanggil opsional yang menerima string OEM terhitung yang sesuai dengan string Unicode di Nama.
[out, optional] NameContainsSpaces
Penunjuk ke nilai BOOLEAN opsional yang menerima TRUE jika string di Nama berisi spasi yang disematkan, FALSE sebaliknya. Nilai ini hanya valid jika RtlIsNameLegalDOS8Dot3 mengembalikan TRUE.
Mengembalikan nilai
RtlIsNameLegalDOS8Dot3 mengembalikan TRUE jika string di Name adalah nama file singkat legal (8,3), false sebaliknya.
Keterangan
RtlIsNameLegalDOS8Dot3 menerjemahkan string Unicode di Nama menggunakan halaman kode OEM yang diinstal sebagai halaman kode sistem saat ini pada waktu boot sistem, dan mengonversi string yang diterjemahkan menjadi huruf besar. (Jika pemanggil menyediakan buffer di OemName, buffer ini menerima string yang dihasilkan.) RtlIsNameLegalDOS8Dot3 memeriksa bahwa nama tersebut adalah nama 8.3 yang diformat dengan benar dan hanya berisi karakter hukum.
Untuk informasi tentang rutinitas penanganan string lainnya, lihat Rutinitas Pustaka Run-Time (RTL).
Jika blok memori di Nama tidak di-patahkan, pemanggil dapat berjalan di IRQL <= DISPATCH_LEVEL. Jika tidak, penelepon RtlIsNameLegalDOS8Dot3 harus berjalan di IRQL < DISPATCH_LEVEL.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ntifs.h (termasuk Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Lihat bagian Keterangan. |