FsRtlIsNameInExpression 関数 (ntifs.h)

  • [アーティクル]

FsRtlIsNameInExpression ルーチンは、Unicode 文字列が指定されたパターンと一致するかどうかを決定します。

構文

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

パラメーター

[in] Expression

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

[in] Name

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

[in] IgnoreCase

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

[in, optional] UpcaseTable

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

戻り値

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

注釈

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

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

リソースが少ない場合、 FsRtlIsNameInExpression は、STATUS_NO_MEMORYのコードを使用して構造化例外を発生させることができます。この例外は、呼び出し元が処理できるように準備する必要があります。 詳細については、「 構造化例外処理」を参照してください。

注意

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

両方のパラメーターが null 文字列の場合、 FsRtlIsNameInExpression はTRUE を返します。

要件

要件 値
サポートされている最小のクライアント このルーチンは Windows 2000 です
対象プラットフォーム ユニバーサル
Header ntifs.h (FltKernel.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

こちらもご覧ください

FsRtlIsDbcsInExpression

UNICODE_STRING