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 del 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 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 legale (8.3), FALSE in caso contrario.

Commenti

RtlIsNameLegalDOS8Dot3 converte la stringa Unicode in Nome usando la tabella codici OEM installata come tabella codici del sistema corrente in fase di avvio del sistema e converte la stringa tradotta in maiuscolo. Se il chiamante ha fornito un buffer in OemName, questo buffer riceve la stringa risultante. RtlIsNameLegalDOS8Dot3 verifica che il nome sia un nome formattato correttamente 8.3 e contenga solo caratteri legali.

Per informazioni sulle altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).

Se il blocco di memoria in Name non è in 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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Vedere La sezione Osservazioni.

Vedi anche

OEM_STRING

RtlGenerate8dot3Name

UNICODE_STRING