Función FsRtlIsNameInExpression (ntifs.h)

  • Artículo

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, Expression 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

Establezca en TRUE para la coincidencia sin distinción entre mayúsculas y minúsculas; en caso contrario, FALSE .

[in, optional] UpcaseTable

Puntero opcional a la tabla de caracteres en mayúsculas que se usará para la coincidencia sin distinción entre mayúsculas y 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.

Comentarios

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 autores de llamadas deben estar preparados para controlar. Para obtener más información, consulte Control de excepciones estructurado.

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 Value
Cliente mínimo compatible Esta rutina es Windows 2000
Plataforma de destino Universal
Encabezado ntifs.h (incluya FltKernel.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

FsRtlIsDbcsInExpression

UNICODE_STRING