Función FsRtlIsNameInExpression (ntifs.h)

La rutina FsRtlIsNameInExpression determina si una cadena Unicode coincide con el patrón especificado.

Sintaxis

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

Parámetros

[in] Expression

Puntero a la cadena de patrón. Puede contener caracteres comodín. Si IgnoreCase es TRUE, expresión debe estar en mayúsculas.

[in] Name

Puntero a la cadena que se va a comparar con el patrón. No se pueden contener caracteres comodín.

[in] IgnoreCase

Establézcalo en TRUE para la coincidencia sin distinción entre mayúsculas y minúsculas, FALSE de lo contrario.

[in, optional] UpcaseTable

Puntero opcional a la tabla de caracteres mayúsculas que se usará para la coincidencia que no distingue mayúsculas de minúsculas. Si no se proporciona este valor, se usa la tabla de caracteres en mayúsculas del sistema predeterminada.

Valor devuelto

FsRtlIsNameInExpression devuelve TRUE si la cadena coincide con el patrón, FALSE de lo contrario.

Observaciones

Los siguientes caracteres comodín se pueden usar en la cadena de patrón.

Carácter comodín	Significado
* (asterisco)	Coincide con cero o más caracteres.
? (signo de interrogación)	Coincide con un solo carácter.
DOS_DOT	Coincide con un punto o cero caracteres más allá de la cadena de nombre.
DOS_QM	Coincide con cualquier carácter único o, al encontrar un punto o un final de cadena de nombre, avanza la expresión hasta el final del conjunto de DOS_QMs contiguos.
DOS_STAR	Coincide con cero o más caracteres hasta que encuentre y coincida con el final . en el nombre.

En condiciones de recursos bajos, FsRtlIsNameInExpression puede generar una excepción estructurada con un código de STATUS_NO_MEMORY, que los llamadores deben estar preparados para controlar. Para obtener más información, consulte control de excepciones estructurados.

Nota

Si solo uno de los parámetros de cadena tiene una longitud de cero, FsRtlIsNameInExpression devuelve FALSE. Esto significa que "*" no coincide con una cadena nula.

Si ambos parámetros son cadenas nulas, FsRtlIsNameInExpression devuelve TRUE.

Requisitos

Requisito	Valor
cliente mínimo admitido	Esta rutina es Windows 2000
de la plataforma de destino de	Universal
encabezado de	ntifs.h (include FltKernel.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

FsRtlIsDbcsInExpression

UNICODE_STRING