Função FsRtlIsHpfsDbcsLegal (ntifs.h)

Artigo
12/21/2024

A rotina de FsRtlIsHpfsDbcsLegal determina se a cadeia de caracteres DBCS (conjunto de caracteres de byte duplo ou ANS) especificada é um nome de arquivo HPFS legal.

Sintaxe

BOOLEAN FsRtlIsHpfsDbcsLegal(
  [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 TRUE se caracteres curinga devem ser considerados legais, caso contrário, FALSE.

[in] PathNamePermissible

Defina como TRUE se DbcsName pode ser um nome de caminho completo contendo caracteres de barra invertida, FALSE se puder ser apenas um nome de 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 FsRtlIsHpfsDbcsLegal retornará TRUE se a cadeia de caracteres for um nome de arquivo HPFS legal, caso contrário, FALSE.

Observações

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

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

Os seguintes caracteres são ilegais em nomes de arquivo HPFS: 0x0000 - 0x001F, " (aspas), / (barra), : (dois pontos), < (sinal menor que), > (sinal maior que), ? (ponto de interrogação), | (barra vertical ou pipe), * (asterisco)
Um nome de arquivo HPFS não pode terminar em um período ou um espaço. Por exemplo, os arquivos "foo" e "foo" são ilegais, enquanto ".foo", " foo" e "foo.bar.foo" são legais.
Um nome de arquivo HPFS pode conter no máximo 255 bytes.
Os nomes de arquivo HPFS são que preservam maiúsculas de minúsculas, mas não diferenciam maiúsculas de minúsculas. Nomes de arquivo em letras minúsculas não são convertidos automaticamente em maiúsculas. No entanto, o caso é ignorado em comparações de nome de arquivo.

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