Fungsi RtlIsNameLegalDOS8Dot3 (ntifs.h)

  • Artikel

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.

Lihat juga

OEM_STRING

RtlGenerate8dot3Name

UNICODE_STRING