CheckNameLegalDOS8Dot3A, fonction (winbase.h)
Détermine si le nom spécifié peut être utilisé pour créer un fichier sur un système de fichiers FAT.
Syntaxe
BOOL CheckNameLegalDOS8Dot3A(
[in] LPCSTR lpName,
[out, optional] LPSTR lpOemName,
[in] DWORD OemNameSize,
[out, optional] PBOOL pbNameContainsSpaces,
[out] PBOOL pbNameLegal
);
Paramètres
[in] lpName
Nom du fichier, au format 8.3.
[out, optional] lpOemName
Pointeur vers une mémoire tampon qui reçoit la chaîne OEM qui correspond à Name. Ce paramètre peut être NULL.
[in] OemNameSize
Taille de la mémoire tampon lpOemName, en caractères. Si lpOemName est NULL, ce paramètre doit être égal à 0 (zéro).
[out, optional] pbNameContainsSpaces
Indique si un nom contient ou non des espaces. Ce paramètre peut être NULL. Si le nom n’est pas un nom de système de fichiers FAT 8.3 valide, ce paramètre n’est pas défini.
[out] pbNameLegal
Si la fonction réussit, ce paramètre indique si un nom de fichier est un nom de fichier FAT 8.3 valide lorsque la page de codes OEM actuelle est appliquée au nom de fichier.
Valeur de retour
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est 0 (zéro). Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Cette fonction peut être utilisée pour déterminer si un nom de fichier peut être transmis à une application Windows 16 bits ou à une application MS-DOS.
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Supporté |
|---|---|
| Protocole SMB (Server Message Block) 3.0 | Oui |
| Basculement transparent SMB 3.0 (TFO) | Voir les remarques |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | Voir les remarques |
| Cluster Shared Volume File System (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
Notez que SMB 3.0 ne prend pas en charge les noms courts sur les partages avec une fonctionnalité de disponibilité continue. Par conséquent, la fonction retourne toujours zéro (échec).
Note
L’en-tête winbase.h définit CheckNameLegalDOS8Dot3 comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista, Windows XP avec SP1 [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |