Expand Minimize

FsRtlIsNameInExpression routine

The FsRtlIsNameInExpression routine determines whether a Unicode string matches the specified pattern.

Syntax


BOOLEAN FsRtlIsNameInExpression(
  _In_      PUNICODE_STRING Expression,
  _In_      PUNICODE_STRING Name,
  _In_      BOOLEAN IgnoreCase,
  _In_opt_  PWCH UpcaseTable
);

Parameters

Expression [in]

A pointer to the pattern string. Can contain wildcard characters. If IgnoreCase is TRUE, Expression must be uppercase.

Name [in]

A pointer to the string to be compared against the pattern. Cannot contain wildcard characters.

IgnoreCase [in]

Set to TRUE for case-insensitive matching, FALSE otherwise.

UpcaseTable [in, optional]

Optional pointer to uppercase character table to use for case-insensitive matching. If this value is not supplied, the default system uppercase character table is used.

Return value

FsRtlIsNameInExpression returns TRUE if the string matches the pattern, FALSE otherwise.

Remarks

The following wildcard characters can be used in the pattern string.

Wildcard characterMeaning

* (asterisk)

Matches zero or more characters.

? (question mark)

Matches a single character.

DOS_DOT

Matches either a period or zero characters beyond the name string.

DOS_QM

Matches any single character or, upon encountering a period or end of name string, advances the expression to the end of the set of contiguous DOS_QMs.

DOS_STAR

Matches zero or more characters until encountering and matching the final . in the name.

 

Note   If only one of the string parameters has a length of zero, FsRtlIsNameInExpression returns FALSE. This means that "*" does not match a null string.

If both parameters are null strings, FsRtlIsNameInExpression returns TRUE.

For information about other string-handling routines, see Strings.

Requirements

Version

This routine is available in Windows 2000 and later versions of the Windows operating system.

Header

Ntifs.h (include FltKernel.h or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

PASSIVE_LEVEL

See also

FsRtlIsDbcsInExpression
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft