Função RtlIsNameLegalDOS8Dot3 (ntifs.h)

A rotina RtlIsNameLegalDOS8Dot3 determina se um determinado nome representa um nome de arquivo curto (8.3) válido.

Sintaxe

NTSYSAPI BOOLEAN RtlIsNameLegalDOS8Dot3(
  [in]            PCUNICODE_STRING Name,
  [in, out]       POEM_STRING      OemName,
  [out, optional] PBOOLEAN         NameContainsSpaces
);

Parâmetros

[in] Name

Ponteiro para uma cadeia de caracteres Unicode que contém o nome do arquivo.

[in, out] OemName

Ponteiro para um buffer opcional alocado pelo chamador que recebe uma cadeia de caracteres OEM contada correspondente à cadeia de caracteres Unicode em Name.

[out, optional] NameContainsSpaces

Ponteiro para um valor BOOLEAN opcional que receberá TRUE se a cadeia de caracteres em Name contiver espaços inseridos; caso contrário, FALSE . Esse valor só será válido se RtlIsNameLegalDOS8Dot3 retornar TRUE.

Retornar valor

RtlIsNameLegalDOS8Dot3 retornará TRUE se a cadeia de caracteres em Name for um nome de arquivo curto legal (8.3), caso contrário, FALSE .

Comentários

RtlIsNameLegalDOS8Dot3 converte a cadeia de caracteres Unicode em Name usando a página de código OEM que foi instalada como a página de código do sistema atual no momento da inicialização do sistema e converte a cadeia de caracteres traduzida em maiúscula. (Se o chamador forneceu um buffer em OemName, esse buffer receberá a cadeia de caracteres resultante.) RtlIsNameLegalDOS8Dot3 verifica se o nome é um nome 8.3 formatado corretamente e contém apenas caracteres legais.

Para obter informações sobre outras rotinas de manipulação de cadeia de caracteres, consulte Rotinas da RTL (Biblioteca em Tempo de Execução).

Se o bloco de memória em Name não forpagado, o chamador poderá estar em execução em IRQL <= DISPATCH_LEVEL. Caso contrário, os chamadores de RtlIsNameLegalDOS8Dot3 devem estar em execução no IRQL < DISPATCH_LEVEL.

Requisitos

Confira também

OEM_STRING

RtlGenerate8dot3Name

UNICODE_STRING