RtlIsNameLegalDOS8Dot3 函数 （ntifs.h）
RtlIsNameLegalDOS8Dot3 例程确定给定名称是否表示有效的短（8.3）文件名。
语法
NTSYSAPI BOOLEAN RtlIsNameLegalDOS8Dot3(
[in] PCUNICODE_STRING Name,
[in, out] POEM_STRING OemName,
[out, optional] PBOOLEAN NameContainsSpaces
);
参数
[in] Name
指向包含文件名的 Unicode 字符串的指针。
[in, out] OemName
指向可选调用方分配的缓冲区的指针，该缓冲区接收与 Name上的 Unicode 字符串对应的计数 OEM 字符串。
[out, optional] NameContainsSpaces
如果 名称 处的字符串包含嵌入空格，则指向可选的 BOOLEAN 值，如果 名称处的字符串包含嵌入空格，则为 FALSE;否则为 FALSE。 仅当 RtlIsNameLegalDOS8Dot3返回 TRUE时，此值才有效。
返回值
RtlIsNameLegalDOS8Dot3 如果 Name 处的字符串是法定短（8.3）文件名，则返回 TRUE;否则返回 FALSE。
言论
RtlIsNameLegalDOS8Dot3 使用在系统启动时作为当前系统代码页安装的 OEM 代码页，在 名称 转换 Unicode 字符串，并将转换后的字符串转换为大写。 （如果调用方在 OemName提供缓冲区，则此缓冲区将接收生成的字符串。RtlIsNameLegalDOS8Dot3 检查名称是否格式正确的 8.3 名称，并且仅包含法定字符。
有关其他字符串处理例程的信息，请参阅 Run-Time Library （RTL） 例程。
如果 名称 处的内存块未分页，则调用方可以在 IRQL <= DISPATCH_LEVEL 上运行。 否则，RtlIsNameLegalDOS8Dot3 的调用方必须在 IRQL < DISPATCH_LEVEL 运行。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 标头 | ntifs.h （include Ntifs.h） |
| 库 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | 请参阅“备注”部分。 |