FindFirstFileExFromAppW 함수(fileapifromapp.h)

디렉터리를 검색하여 지정된 이름 및 특성과 일치하는 파일 또는 하위 디렉터리를 찾습니다. 이 함수는 유니버설 Windows 플랫폼 앱 보안 모델을 준수한다는 점을 제외하고 이 함수의 동작은 FindFirstFileEx와 동일합니다.

구문

WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
  LPCWSTR            lpFileName,
  FINDEX_INFO_LEVELS fInfoLevelId,
  LPVOID             lpFindFileData,
  FINDEX_SEARCH_OPS  fSearchOp,
  LPVOID             lpSearchFilter,
  DWORD              dwAdditionalFlags
) noexcept;

매개 변수

lpFileName

디렉터리 또는 경로 및 파일 이름입니다. 파일 이름에는 와일드카드 문자(예: 별표(*) 또는 물음표(?)가 포함될 수 있습니다.

이 매개 변수는 NULL, 잘못된 문자열(예: 빈 문자열 또는 종료 null 문자가 없는 문자열) 또는 후행 백슬래시(\)로 끝나서는 안 됩니다.

문자열이 와일드카드, 마침표 또는 디렉터리 이름으로 끝나는 경우 사용자는 경로의 루트 및 모든 하위 디렉터리에 액세스할 수 있어야 합니다.

"\\?\" 앞에 추가하지 않고 MAX_PATH 제한을 옵트아웃하는 방법에 대한 자세한 내용은 파일, 경로 및 네임스페이스의 "최대 경로 길이 제한" 섹션을 참조하세요.

fInfoLevelId

반환된 데이터의 정보 수준입니다.

이 매개 변수는 FINDEX_INFO_LEVELS 열거형 값 중 하나입니다.

lpFindFileData

파일 데이터를 수신하는 버퍼에 대한 포인터입니다.

포인터 형식은 fInfoLevelId 매개 변수에 지정된 정보 수준에 따라 결정됩니다.

fSearchOp

수행할 필터링 유형으로 와일드카드 일치와 다릅니다.

이 매개 변수는 FINDEX_SEARCH_OPS 열거형 값 중 하나입니다.

lpSearchFilter

지정된 fSearchOp 에 구조화된 검색 정보가 필요한 경우 검색 조건에 대한 포인터입니다.

현재 지원되는 fSearchOp 값에는 확장 검색 정보가 필요하지 않습니다. 따라서 이 포인터는 NULL이어야 합니다.

dwAdditionalFlags

검색을 제어하는 추가 플래그를 지정합니다.

값	의미
FIND_FIRST_EX_CASE_SENSITIVE 1	검색은 대/소문자를 구분합니다.
FIND_FIRST_EX_LARGE_FETCH 2	찾기 작업의 성능을 높일 수 있는 디렉터리 쿼리에 더 큰 버퍼를 사용합니다.
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4	결과를 디스크에 물리적으로 있는 파일로 제한합니다. 이 플래그는 파일 가상화 필터가 있는 경우에만 관련이 있습니다.

반환 값

함수가 성공하면 반환 값은 FindNextFile 또는 FindClose에 대한 후속 호출에 사용되는 검색 핸들이며 lpFindFileData 매개 변수에는 발견된 첫 번째 파일 또는 디렉터리에 대한 정보가 포함됩니다.

함수가 lpFileName 매개 변수의 검색 문자열에서 파일을 찾지 못하거나 실패하면 반환 값이 INVALID_HANDLE_VALUElpFindFileData 의 내용이 확정되지 않습니다. 확장 오류 정보를 가져오려면 GetLastError 함수를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1803
머리글	fileapifromapp.h