다음을 통해 공유


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 프로토콜 아니요
SMB 3.0 TFO(투명한 장애 조치(failover) 아니요
SO(스케일 아웃 파일 공유)가 있는 SMB 3.0 아니요
CsvFS(클러스터 공유 볼륨 파일 시스템)
 

트랜잭션 작업

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

요구 사항

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

참고 항목

저널 변경

CreateFile

DeviceIoControl

겹치는

볼륨 관리 제어 코드