GetFileInformationByHandle 함수(fileapi.h)

지정된 파일의 파일 정보를 검색합니다.

이 함수의 고급 버전은 GetFileInformationByHandleEx를 참조하세요.

파일 핸들을 사용하여 파일 정보를 설정하려면 SetFileInformationByHandle을 참조하세요.

구문

BOOL GetFileInformationByHandle(
  [in]  HANDLE                       hFile,
  [out] LPBY_HANDLE_FILE_INFORMATION lpFileInformation
);

매개 변수

[in] hFile

검색할 정보가 포함된 파일에 대한 핸들입니다.

이 핸들은 파이프 핸들이 아니어야 합니다.

[out] lpFileInformation

파일 정보를 수신하는 BY_HANDLE_FILE_INFORMATION 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 0이 아니고 lpFileInformation 매개 변수가 가리키는 버퍼에 파일 정보 데이터가 포함됩니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

운영 체제의 기본 네트워크 기능 및 연결된 서버 유형에 따라 GetFileInformationByHandle 함수가 실패하거나, 부분 정보를 반환하거나, 지정된 파일에 대한 전체 정보를 반환할 수 있습니다.

BY_HANDLE_FILE_INFORMATION 구조에서 반환된 VolumeSerialNumber 및 FileIndex 멤버를 비교하여 두 경로가 동일한 대상에 매핑되는지 확인할 수 있습니다. 예를 들어 두 파일 경로를 비교하고 동일한 디렉터리에 매핑되는지 확인할 수 있습니다.

IIn Windows 8 및 Windows Server 2012 이 함수는 다음 기술에서 지원됩니다.

기술	지원됨
SMB(서버 메시지 블록) 3.0 프로토콜	Yes
SMB 3.0 TFO(투명 장애 조치(failover))	Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0	Yes
CsvFS(클러스터 공유 볼륨 파일 시스템)	Yes
ReFS(Resilient File System)	Yes

 

거래된 작업

호출 시 스레드에 바인딩된 트랜잭션이 있는 경우 함수는 격리된 파일 뷰의 압축된 파일 크기를 반환합니다. 자세한 내용은 트랜잭션 NTFS 정보를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	fileapi.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

파일 관리 함수

GetFileInformationByHandleEx

SetFileInformationByHandle