Função FsRtlIsFatDbcsLegal (ntifs.h)

Artigo
12/21/2024

A rotina FsRtlIsFatDbcsLegal determina se a cadeia de caracteres DBCS (conjunto de caracteres de byte duplo) ou ANSI especificada é um nome de arquivo FAT legal.

Sintaxe

BOOLEAN FsRtlIsFatDbcsLegal(
  [in] ANSI_STRING DbcsName,
  [in] BOOLEAN     WildCardsPermissible,
  [in] BOOLEAN     PathNamePermissible,
  [in] BOOLEAN     LeadingBackslashPermissible
);

Parâmetros

[in] DbcsName

Um ponteiro para a cadeia de caracteres a ser testada.

[in] WildCardsPermissible

Defina como verdadeiro se caracteres curinga forem considerados legais, FALSE caso contrário.

[in] PathNamePermissible

Defina como TRUE se DbcsName pode ser um nome de caminho completo contendo caracteres de barra invertida, false se puder ser apenas o nome do arquivo.

[in] LeadingBackslashPermissible

Defina como true se uma única barra invertida à esquerda for permitida no arquivo ou nome de caminho, FALSE caso contrário.

Valor de retorno

A rotina FsRtlIsFatDbcsLegal retorna VERDADEIRO se a cadeia de caracteres for um nome de arquivo FAT legal, FALSE caso contrário.

Observações

A rotina FsRtlIsFatDbcsLegal determina se o nome do arquivo especificado está em conformidade com as regras específicas do FAT para nomes de arquivo legais. Essa rotina verificará o nome do arquivo ou, se PathNamePermissible for especificado como VERDADEIRO, se todo o nome do caminho é um nome FAT legal.

Os nomes de arquivo FAT devem obedecer às seguintes regras:

Os seguintes caracteres são ilegais em nomes de arquivo FAT: 0x00-0x1F, " (aspas retas), / (barra), : (dois-pontos), | (barra vertical ou pipe), + (mais), , (vírgula), ; (ponto e vírgula), = (sinal igual), [ ] (colchetes)
Um nome de arquivo FAT é um dos formulários N.E ou apenas N, em que N é uma cadeia de caracteres de um a oito bytes e E é uma cadeia de caracteres de um a três bytes em conformidade com a regra um. Além disso, nem N nem E podem conter um . (ponto) ou terminar com um caractere de espaço. Por exemplo, os arquivos .foo, foo.e foo .b são ilegais, enquanto foo. b e bar são legais.
Nomes de arquivo FAT não diferenciam maiúsculas de minúsculas. Nomes minúsculos são convertidos automaticamente em maiúsculas.

Para obter informações sobre outras rotinas de tratamento de cadeias de caracteres, consulte Run-Time Rotinas da Biblioteca de Run-Time (RTL).

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000
da Plataforma de Destino	Universal
cabeçalho	ntifs.h (inclua FltKernel.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

ANSI_STRING

Compartilhar via