Edit

FsRtlIsDbcsInExpression function (ntifs.h)

  • Article

The FsRtlIsDbcsInExpression routine determines whether an ANSI or double-byte character set (DBCS) string matches the specified pattern.

Syntax

BOOLEAN FsRtlIsDbcsInExpression(
  [in] PANSI_STRING Expression,
  [in] PANSI_STRING Name
);

Parameters

[in] Expression

A pointer to the pattern string. Can contain wildcard characters.

[in] Name

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

Return value

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

Remarks

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

Wildcard Character Meaning
* (asterisk) Matches zero or more characters.
? (question mark) Matches a single character.
ANSI_DOS_DOT Matches either a period or zero characters beyond the name string.
ANSI_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 ANSI_DOS_QMs.
ANSI_DOS_STAR Matches zero or more characters until encountering and matching the final . in the name.
 

Pattern matching is case sensitive. To perform a case-insensitive match, the caller must use a routine such as RtlUpperString to convert the pattern and input strings to uppercase before calling FsRtlIsDbcsInExpression.

For information about other string-handling routines, see Run-Time Library (RTL) Routines.

Requirements

Requirement Value
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

See also

ANSI_STRING

FsRtlIsNameInExpression

RtlUpperString