Función RtlIsNameLegalDOS8Dot3 (ntifs.h)
La rutina RtlIsNameLegalDOS8Dot3 determina si un nombre determinado representa un nombre de archivo corto (8.3) válido.
Sintaxis
NTSYSAPI BOOLEAN RtlIsNameLegalDOS8Dot3(
[in] PCUNICODE_STRING Name,
[in, out] POEM_STRING OemName,
[out, optional] PBOOLEAN NameContainsSpaces
);
Parámetros
[in] Name
Puntero a una cadena Unicode que contiene el nombre de archivo.
[in, out] OemName
Puntero a un búfer asignado por el autor de la llamada opcional que recibe una cadena OEM con recuento correspondiente a la cadena Unicode en Nombre.
[out, optional] NameContainsSpaces
Puntero a un valor BOOLEAN opcional que recibe TRUE si la cadena en Name contiene espacios incrustados; en caso contrario, FALSE. Este valor solo es válido si RtlIsNameLegalDOS8Dot3 devuelve TRUE.
Valor devuelto
RtlIsNameLegalDOS8Dot3 devuelve TRUE si la cadena en Name es un nombre de archivo corto legal (8.3), FALSE en caso contrario.
Comentarios
RtlIsNameLegalDOS8Dot3 traduce la cadena Unicode en Name mediante la página de códigos OEM que se instaló como la página de códigos del sistema actual en tiempo de arranque del sistema y convierte la cadena traducida en mayúsculas. (Si el autor de la llamada proporcionó un búfer en OemName, este búfer recibe la cadena resultante). RtlIsNameLegalDOS8Dot3 comprueba que el nombre tiene el formato correcto 8.3 y solo contiene caracteres legales.
Para obtener información sobre otras rutinas de control de cadenas, vea Rutinas de la biblioteca en tiempo de ejecución (RTL).
Si el bloque de memoria en Name no está paginado, el autor de la llamada se puede ejecutar en IRQL <= DISPATCH_LEVEL. De lo contrario, los autores de llamadas de RtlIsNameLegalDOS8Dot3 deben ejecutarse en irQL < DISPATCH_LEVEL.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | vea la sección Comentarios. |