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 de fichier.

[in, out] OemName

Pointeur vers une mémoire tampon facultative allouée à l’appelant qui reçoit une chaîne OEM comptée correspondant à la chaîne Unicode dans Nom.

[out, optional] NameContainsSpaces

Pointeur vers une valeur BOOLEAN facultative qui reçoit TRUE si la chaîne dans Nom contient des espaces incorporés ; sinon, FALSE . Cette valeur est valide uniquement si RtlIsNameLegalDOS8Dot3 renvoie TRUE.

Valeur retournée

RtlIsNameLegalDOS8Dot3 retourne TRUE si la chaîne dans Name est un nom de fichier court (8.3) légal, FALSE dans le cas contraire.

Remarques

RtlIsNameLegalDOS8Dot3 traduit la chaîne Unicode dans Name à l’aide de la page de codes OEM qui a été 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 sur 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 juridiques.

Pour plus d’informations sur les autres routines de gestion de chaînes, consultez Routines de la bibliothèque d’exécution (RTL).

Si le bloc de mémoire sur Nom n’est pas paginé, l’appelant peut s’exécuter sur IRQL <= DISPATCH_LEVEL. Sinon, les appelants de RtlIsNameLegalDOS8Dot3 doivent être en cours d’exécution sur irQL < DISPATCH_LEVEL.

Configuration requise

Voir aussi

OEM_STRING

RtlGenerate8dot3Name

UNICODE_STRING