RtlIsNameLegalDOS8Dot3, fonction (ntifs.h)
La routine RtlIsNameLegalDOS8Dot3 détermine si un nom donné représente un nom de fichier court (8.3) valide.
Syntaxe
NTSYSAPI BOOLEAN RtlIsNameLegalDOS8Dot3(
[in] PCUNICODE_STRING Name,
[in, out] POEM_STRING OemName,
[out, optional] PBOOLEAN NameContainsSpaces
);
Paramètres
[in] Name
Pointeur vers une chaîne Unicode contenant le nom du fichier.
[in, out] OemName
Pointeur vers une mémoire tampon allouée par l’appelant facultatif qui reçoit une chaîne OEM comptée correspondant à la chaîne Unicode à Nom.
[out, optional] NameContainsSpaces
Pointeur vers une valeur BOOLEAN facultative qui reçoit TRUE si la chaîne à Name contient des espaces incorporés, FALSE sinon. Cette valeur n’est valide que si RtlIsNameLegalDOS8Dot3 retourne TRUE.
Valeur de retour
RtlIsNameLegalDOS8Dot3 retourne TRUE si la chaîne à Name est un nom de fichier court (8.3) légal, FALSE sinon.
Remarques
RtlIsNameLegalDOS8Dot 3 traduit la chaîne Unicode à Name à l’aide de la page de codes OEM installée en tant que page de codes système actuelle au démarrage du système et convertit la chaîne traduite en majuscules. (Si l’appelant a fourni une mémoire tampon à oemName, cette mémoire tampon reçoit la chaîne résultante.) RtlIsNameLegalDOS8Dot3 vérifie que le nom est un nom 8.3 correctement mis en forme et ne contient que des caractères légaux.
Pour plus d’informations sur les autres routines de gestion des chaînes, consultez Run-Time Routines de bibliothèque (RTL).
Si le bloc de mémoire à Nom n’est pas paginé, l’appelant peut s’exécuter à l'<IRQL = DISPATCH_LEVEL. Sinon, les appelants de RtlIsNameLegalDOS8Dot3 doivent s’exécuter à l'< DISPATCH_LEVEL IRQL.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Voir la section Remarques. |