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

Consulte también

OEM_STRING

RtlGenerate8dot3Name

UNICODE_STRING