FsRtlIsNameInUnUpcasedExpression 関数 (ntifs.h)

FsRtlIsNameInUnUpcasedExpression ルーチンは、Unicode 文字列が指定されたパターンと一致するかどうかを決定します。 FsRtlIsNameInExpression ルーチンとは異なり、IgnoreCase が TRUE の場合、FsRtlIsNameInUnUpcasedExpression は式が大文字であるとは想定しません。

構文

BOOLEAN FsRtlIsNameInUnUpcasedExpression(
  PUNICODE_STRING Expression,
  PUNICODE_STRING Name,
  BOOLEAN         IgnoreCase,
  PWCH            UpcaseTable
);

パラメーター

Expression

パターン文字列へのポインター。 ワイルドカード文字を含めることができます。 IgnoreCase が TRUE の場合、Expression は小文字にする必要があります。

Name

パターンと比較する文字列へのポインター。 ワイルドカード文字を含めることはできません。

IgnoreCase

大文字と小文字を区別しない照合の場合は TRUE 、それ以外の場合 は FALSE に設定します。

UpcaseTable

大文字と小文字を区別しない照合に使用する大文字のテーブルへの省略可能なポインター。 この値が指定されていない場合は、既定のシステム大文字テーブルが使用されます。

戻り値

文字列がパターンと一致する場合は TRUE、それ以外の場合は FALSE を返します。

注釈

パターン文字列では、次のワイルドカード文字を使用できます。

ワイルドカード文字	意味
* (アスタリスク)	0 個以上の文字と一致します。
? (疑問符)	1 文字に一致します。
DOS_DOT	名前文字列を超えるピリオドまたは 0 文字のいずれかと一致します。
DOS_QM	任意の 1 文字に一致するか、ピリオドまたは名前文字列の末尾を検出すると、式を連続するDOS_QMsのセットの末尾に進めます。
DOS_STAR	名前の最後のピリオドを検出して一致するまで、0 個以上の文字と一致します。

注

文字列パラメーターの長さが 0 の場合、FsRtlIsNameInUnUpcasedExpression は FALSE を返します。 これは、"*" が null 文字列と一致しないことを意味します。 両方のパラメーターが null 文字列の場合、FsRtlIsNameInUnUpcasedExpression は TRUE を返します。

要件

要件	値
サポートされている最小のクライアント	Windows 10 (バージョン 1803)
対象プラットフォーム	ユニバーサル
Header	ntifs.h
Library	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• FsRtlIsNameInExpression