FSCTL_WRITE_USN_CLOSE_RECORD IOCTL(winioctl.h)

  • 아티클

입력 파일에 대한 USN(업데이트 시퀀스 번호) 변경 저널 스트림에 레코드를 생성합니다. 이 레코드에는 USN_REASON_CLOSE 플래그가 있습니다.

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

C++ 
BOOL 
WINAPI
DeviceIoControl( (HANDLE) hDevice,              // handle to volume
                 FSCTL_WRITE_USN_CLOSE_RECORD,  // dwIoControlCodeNULL,                          // lpInBuffer0,                             // nInBufferSize(LPVOID) lpOutBuffer,          // output buffer
                 (DWORD) nOutBufferSize,        // size of output buffer
                 (LPDWORD) lpBytesReturned,     // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

설명

이 작업에 겹치는 I/O의 의미는 DeviceIoControl에 대한 설명 섹션을 참조하세요.

FSCTL_WRITE_USN_CLOSE_RECORD 사용하여 입력 핸들의 변경 저널로 닫기 레코드를 강제로 적용할 수 있습니다. 닫기 레코드에는 이 파일에 대한 현재 USN 이유도 포함됩니다. 출력 버퍼는 이 작업과 연결된 USN 값을 반환합니다.

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

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

\.\X:

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

fsutil 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
 

거래된 작업

트랜잭션에 의해 잠긴 핸들을 사용하여 FSCTL_WRITE_USN_CLOSE_RECORD 호출되면 항상 실패합니다.

요구 사항

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

추가 정보

변경 저널

CreateFile

DeviceIoControl

OVERLAPPED

볼륨 관리 제어 코드