Función CheckNameLegalDOS8Dot3A (winbase.h)
Determina si el nombre especificado se puede usar para crear un archivo en un sistema de archivos FAT.
Sintaxis
BOOL CheckNameLegalDOS8Dot3A(
[in] LPCSTR lpName,
[out, optional] LPSTR lpOemName,
[in] DWORD OemNameSize,
[out, optional] PBOOL pbNameContainsSpaces,
[out] PBOOL pbNameLegal
);
Parámetros
[in] lpName
Nombre de archivo, en formato 8.3.
[out, optional] lpOemName
Puntero a un búfer que recibe la cadena oem que corresponde a Nombre. Este parámetro puede ser null.
[in] OemNameSize
Tamaño del búfer de lpOemName, en caracteres. Si lpOemName es null, este parámetro debe ser 0 (cero).
[out, optional] pbNameContainsSpaces
Indica si un nombre contiene o no espacios. Este parámetro puede ser null. Si el nombre no es un nombre válido del sistema de archivos FAT 8.3, este parámetro no está definido.
[out] pbNameLegal
Si la función se ejecuta correctamente, este parámetro indica si un nombre de archivo es un nombre de archivo FAT válido 8.3 cuando se aplica la página de códigos OEM actual al nombre de archivo.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la función, el valor devuelto es 0 (cero). Para obtener información de error extendida, llame a GetLastError.
Observaciones
Esta función se puede usar para determinar si se puede pasar o no un nombre de archivo a una aplicación basada en Windows de 16 bits o a una aplicación basada en MS-DOS.
En Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.
| Tecnología | Soportado |
|---|---|
| Protocolo bloque de mensajes del servidor (SMB) 3.0 | Sí |
| Conmutación por error transparente (TFO) de SMB 3.0 | Ver comentarios |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | Ver comentarios |
| Sistema de archivos de volumen compartido de clúster (CsvFS) | Sí |
| Sistema de archivos resistente (ReFS) | Sí |
Tenga en cuenta que SMB 3.0 no admite nombres cortos en recursos compartidos con capacidad de disponibilidad continua, por lo que la función siempre devolverá cero (error).
Nota
El encabezado winbase.h define CheckNameLegalDOS8Dot3 como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista, Windows XP con SP1 [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winbase.h (incluya Windows.h) |
| biblioteca de |
Kernel32.lib |
| DLL de |
Kernel32.dll |