Função FsRtlIsNameInUnUpcasedExpression (ntifs.h)

  • Artigo

A rotina FsRtlIsNameInUnUpcasedExpression determina se uma cadeia de caracteres Unicode corresponde ao padrão especificado. Ao contrário da rotina FsRtlIsNameInExpression, FsRtlIsNameInUnUpcasedExpression não espera que a expressão esteja em maiúsculas se IgnoreCase for TRUE.

Sintaxe

BOOLEAN FsRtlIsNameInUnUpcasedExpression(
  PUNICODE_STRING Expression,
  PUNICODE_STRING Name,
  BOOLEAN         IgnoreCase,
  PWCH            UpcaseTable
);

Parâmetros

Expression

Um ponteiro para a cadeia de caracteres padrão. Pode conter caracteres curinga. Se IgnoreCase for TRUE, Expression deverá ser minúscula.

Name

Um ponteiro para a cadeia de caracteres a ser comparada com o padrão. Não é possível conter caracteres curinga.

IgnoreCase

Defina como TRUE para correspondência sem diferenciação de maiúsculas e minúsculas, caso contrário, FALSE.

UpcaseTable

Ponteiro opcional para a tabela de caracteres maiúsculas a ser usada para correspondência sem diferenciação de maiúsculas e minúsculas. Se esse valor não for fornecido, a tabela de caracteres maiúsculas do sistema padrão será usada.

Retornar valor

Retornará TRUE se a cadeia de caracteres corresponder ao padrão, caso contrário, FALSE.

Comentários

Os seguintes caracteres curinga podem ser usados na cadeia de caracteres padrão:

Caractere curinga Significado
* (asterisco) Corresponde a zero ou mais caracteres.
? (ponto de interrogação) Corresponde a um único caractere.
DOS_DOT Corresponde a um ponto ou zero caracteres além da cadeia de caracteres de nome.
DOS_QM Corresponde a qualquer caractere único ou, ao encontrar um ponto ou fim da cadeia de caracteres de nome, avança a expressão para o final do conjunto de DOS_QMs contíguos.
DOS_STAR Corresponde a zero ou mais caracteres até encontrar e corresponder ao período final no nome.

Observação

Se apenas um dos parâmetros de cadeia de caracteres tiver um comprimento de zero, FsRtlIsNameInUnUpcasedExpression retornará FALSE. Isso significa que "*" não corresponde a uma cadeia de caracteres nula. Se ambos os parâmetros forem cadeias de caracteres nulas, FsRtlIsNameInUnUpcasedExpression retornará TRUE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 (versão 1803)
Plataforma de Destino Universal
Cabeçalho ntifs.h
Biblioteca NtosKrnl.exe
IRQL PASSIVE_LEVEL

Confira também