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) |