Funzione RtlIsNameLegalDOS8Dot3 (ntifs.h)
La routine RtlIsNameLegalDOS8Dot3 determina se un nome specificato rappresenta un nome di file breve (8.3) valido.
Sintassi
NTSYSAPI BOOLEAN RtlIsNameLegalDOS8Dot3(
[in] PCUNICODE_STRING Name,
[in, out] POEM_STRING OemName,
[out, optional] PBOOLEAN NameContainsSpaces
);
Parametri
[in] Name
Puntatore a una stringa Unicode contenente il nome del file.
[in, out] OemName
Puntatore a un buffer allocato dal chiamante facoltativo che riceve una stringa OEM conteggiata corrispondente alla stringa Unicode in Nome.
[out, optional] NameContainsSpaces
Puntatore a un valore BOOLEAN facoltativo che riceve TRUE se la stringa in corrispondenza del nome contiene spazi incorporati, FALSE in caso contrario. Questo valore è valido solo se RtlIsNameLegalDOS8Dot3 restituisce TRUE.
Valore restituito
RtlIsNameLegalDOS8Dot3 restituisce true se la stringa in Name è un nome di file valido (8,3), FALSE in caso contrario.
Osservazioni
RtlIsNameLegalDOS8Dot3 converte la stringa Unicode in Name usando la tabella codici OEM installata come tabella codici di sistema corrente in fase di avvio del sistema e converte la stringa tradotta in maiuscolo. Se il chiamante ha fornito un buffer in corrispondenza di OemName, questo buffer riceve la stringa risultante. RtlIsNameLegalDOS8Dot3 verifica che il nome sia formattato correttamente 8.3 e contenga solo caratteri legali.
Per informazioni su altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).
Se il blocco di memoria in corrispondenza di Nome non è di pagina, il chiamante può essere in esecuzione in IRQL <= DISPATCH_LEVEL. In caso contrario, i chiamanti di RtlIsNameLegalDOS8Dot3 devono essere in esecuzione in IRQL < DISPATCH_LEVEL.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ntifs.h (include Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | Vedere la sezione Osservazioni. |