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
選擇性呼叫端配置的緩衝區指標，該緩衝區會接收對應至 名稱之 Unicode 字串的計算 OEM 字串。
[out, optional] NameContainsSpaces
如果Name 上的字串包含內嵌空格，則為選擇性 BOOLEAN 值的指標，否則為 FALSE。 只有在 RtlIsNameLegalDOS8Dot3 傳回 TRUE 時，這個值才有效。
傳回值
如果 Name 的字串是合法的簡短 (8.3) 檔名，則 RtlIsNameLegalDOS8Dot3 會傳回 TRUE，否則為 FALSE。
備註
RtlIsNameLegalDOS8Dot3 會使用在系統開機時安裝為目前系統代碼頁的 OEM 代碼頁，在 Name 中轉譯 Unicode 字元串，並將翻譯的字串轉換成大寫。 (如果呼叫端在 OemName 提供緩衝區，則此緩衝區會收到產生的 string.) RtlIsNameLegalDOS8Dot3 會檢查名稱是否為格式正確的 8.3 名稱，且只包含合法字元。
如需其他字串處理程式的資訊，請參閱 Run-Time Library (RTL) 例程。
如果 Name 的記憶體區塊為非分頁，則呼叫端可以在 IRQL <= DISPATCH_LEVEL執行。 否則， RtlIsNameLegalDOS8Dot3 的呼叫端必須在 IRQL < DISPATCH_LEVEL上執行。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | 請參閱一節。 |