Função FsRtlIsNameInUnUpcasedExpression (ntifs.h)

Artigo
12/21/2024

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, a expressão 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 que não diferencia maiúsculas de minúsculas, false caso contrário.

UpcaseTable

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

Valor de retorno

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

Observações

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.

de 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
de cliente com suporte mínimo	Windows 10 (versão 1803)
da Plataforma de Destino	Universal
cabeçalho	ntifs.h
biblioteca	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Consulte também

FsRtlIsNameInExpression

Compartilhar via