FsRtlIsNameInExpression 함수(ntifs.h)

FsRtlIsNameInExpression 루틴은 유니코드 문자열이 지정된 패턴과 일치하는지 여부를 결정합니다.

구문

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

매개 변수

[in] Expression

패턴 문자열에 대한 포인터입니다. 와일드카드 문자를 포함할 수 있습니다. IgnoreCase가 TRUE이면 식은 대문자여야 합니다.

[in] Name

패턴과 비교할 문자열에 대한 포인터입니다. 와일드카드 문자를 포함할 수 없습니다.

[in] IgnoreCase

대/소문자를 구분하지 않는 일치를 위해 TRUE 로 설정하고, 그렇지 않으면 FALSE 로 설정합니다.

[in, optional] UpcaseTable

대/소문자를 구분하지 않는 일치에 사용할 대문자 테이블에 대한 선택적 포인터입니다. 이 값을 제공하지 않으면 기본 시스템 대문자 테이블이 사용됩니다.

반환 값

FsRtlIsNameInExpression 은 문자열이 패턴과 일치하면 TRUE 를 반환하고, 그렇지 않으면 FALSE 를 반환합니다.

설명

패턴 문자열에는 다음 와일드카드 문자를 사용할 수 있습니다.

와일드카드 문자	의미
*(별표)	0개 이상의 문자와 일치합니다.
? (물음표)	단일 문자와 일치합니다.
DOS_DOT	이름 문자열을 벗어나는 마침표 또는 0자를 찾습니다.
DOS_QM	임의의 단일 문자와 일치하거나 이름 문자열의 마침표 또는 끝이 발생하면 식을 연속 DOS_QMs 집합의 끝으로 이동합니다.
DOS_STAR	최종 가 발견되고 일치할 때까지 0개 이상의 문자를 일치합니다. 을 입력합니다.

리소스가 부족한 경우 FsRtlIsNameInExpression 은 호출자가 처리할 준비를 해야 하는 STATUS_NO_MEMORY 코드를 사용하여 구조화된 예외를 발생시킬 수 있습니다. 자세한 내용은 구조적 예외 처리를 참조하세요.

참고

문자열 매개 변수 중 하나만 길이가 0이면 FsRtlIsNameInExpression 은 FALSE를 반환합니다. 즉, "*"가 null 문자열과 일치하지 않습니다.

두 매개 변수가 모두 null 문자열이면 FsRtlIsNameInExpression 은 TRUE를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	이 루틴은 Windows 2000입니다.
대상 플랫폼	유니버설
헤더	ntifs.h(FltKernel.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

추가 정보

FsRtlIsDbcsInExpression

UNICODE_STRING