Função FsRtlIsNameInExpression (ntifs.h)
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 VERDADEIRO, de Expressão deverá ser maiúscula.
[in] Name
Um ponteiro para a cadeia de caracteres a ser comparada com o padrão. Não é possível conter caracteres curinga.
[in] IgnoreCase
Defina como TRUE para correspondência que não diferencia maiúsculas de minúsculas, false caso contrário.
[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.
Valor de retorno
FsRtlIsNameInExpression retornará verdadeiro se a cadeia de caracteres corresponder ao padrão, false caso contrário.
Observações
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 recursos baixos, 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 de tratamento de exceção estruturada.
Nota
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 |
|---|---|
| de cliente com suporte mínimo | Essa rotina é o Windows 2000 |
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (inclua FltKernel.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |