Função FsRtlIsNameInExpression (ntifs.h)

  • Artigo

A rotina FsRtlIsNameInExpression determina se uma cadeia de caracteres Unicode corresponde ao padrão especificado.

Sintaxe

BOOLEAN FsRtlIsNameInExpression(
  [in]           PUNICODE_STRING Expression,
  [in]           PUNICODE_STRING Name,
  [in]           BOOLEAN         IgnoreCase,
  [in, optional] PWCH            UpcaseTable
);

Parâmetros

[in] Expression

Um ponteiro para a cadeia de caracteres padrão. Pode conter caracteres curinga. Se IgnoreCase for TRUE, Expression deverá estar em maiúsculas.

[in] Name

Um ponteiro para a cadeia de caracteres a ser comparada com o padrão. Não pode conter caracteres curinga.

[in] IgnoreCase

Defina como TRUE para correspondência que não diferencia maiúsculas de minúsculas ; caso contrário, FALSE.

[in, optional] 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.

Retornar valor

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

Comentários

Os caracteres curinga a seguir 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 final. no nome.

Em condições de pouco recurso, FsRtlIsNameInExpression pode gerar uma exceção estruturada com um código de STATUS_NO_MEMORY, que os chamadores devem estar preparados para lidar. Para obter mais informações, consulte Tratamento de exceções estruturadas.

Observação

Se apenas um dos parâmetros de cadeia de caracteres tiver um comprimento de zero, FsRtlIsNameInExpression retornaráFALSE. Isso significa que "*" não corresponde a uma cadeia de caracteres nula.

Se ambos os parâmetros forem cadeias de caracteres nulas, FsRtlIsNameInExpression retornaráTRUE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Essa rotina é o Windows 2000
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua FltKernel.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

FsRtlIsDbcsInExpression

UNICODE_STRING