FSCTL_READ_FILE_USN_DATA IOCTL(winioctl.h)

  • 아티클

지정된 파일 또는 디렉터리에 대한 USN(업데이트 시퀀스 번호) 변경 저널 정보를 검색합니다.

이 작업을 수행하려면 다음 매개 변수를 사용하여 DeviceIoControl 함수를 호출합니다.

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                 (DWORD) FSCTL_READ_FILE_USN_DATA, // dwIoControlCode(LPVOID)       lpInBuffer,      // input buffer
                 (DWORD)        nInBufferSize,   // size of input buffer
                 (LPVOID)       lpOutBuffer,     // output buffer
                 (DWORD)        nOutBufferSize,  // size of output buffer
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

설명

호출이 성공하면 반환된 USN_RECORD_V2 또는 USN_RECORD_V3 구조체의 멤버는 TimeStamp, Reason 및 SourceInfo 멤버를 제외하고 유효합니다. Usn 멤버는 이 파일 또는 디렉터리에 대한 저널에 마지막으로 작성된 USN을 나타냅니다.

자세한 내용은 변경 저널 만들기, 수정 및 삭제를 참조하세요.

볼륨에 대한 핸들을 검색하려면 lpFileName 매개 변수가 다음 형식의 문자열로 설정된 CreateFile을 호출합니다.

\.\X:

앞의 문자열에서 X 는 볼륨이 표시되는 드라이브를 식별하는 문자입니다. 볼륨은 ReFS 또는 NTFS 3.0 이상이어야 합니다. 볼륨의 NTFS 버전을 가져오려면 관리자 액세스 권한으로 명령 프롬프트를 열고 다음 명령을 실행합니다.

FSUtil.exe FSInfo NTFSInfo X:

여기서 X는 볼륨의 드라이브 문자입니다.

Windows 8 및 Windows Server 2012 이 코드는 다음 기술에서 지원됩니다.

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 winioctl.h(Windows.h 포함)

추가 정보

CreateFile

DeviceIoControl

USN_RECORD

볼륨 관리 제어 코드