FSCTL_UNLOCK_VOLUME IOCTL(winioctl.h)

볼륨의 잠금을 해제합니다.

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,            // handle to a volume
  FSCTL_UNLOCK_VOLUME,         // dwIoControlCode
  NULL,                        // lpInBuffer
  0,                           // nInBufferSize
  NULL,                        // lpOutBuffer
  0,                           // nOutBufferSize
  (LPDWORD) lpBytesReturned,   // number of bytes returned
  (LPOVERLAPPED) lpOverlapped  // OVERLAPPED structure
);

요청이 성공하면 Irp->IoStatus.Status가 STATUS_SUCCESS 설정됩니다.

그렇지 않으면 NTSTATUS 코드로 적절한 오류 조건에 대한 상태입니다.

자세한 내용은 NTSTATUS 값참조하세요.

발언

볼륨을 잠그려면 FSCTL_LOCK_VOLUME 제어 코드를 사용합니다.

DeviceIoControl 전달된 hDevice 핸들은 직접 액세스를 위해 열린 볼륨에 대한 핸들이어야 합니다. 이 핸들을 검색하려면 lpFileName 매개 변수가 다음 형식의 문자열로 설정된 CreateFile 호출합니다.

\\.\X:

여기서 X 하드 드라이브 파티션 문자, 플로피 디스크 드라이브 또는 CD-ROM 드라이브입니다. 또한 애플리케이션은 CreateFiledwShareMode 매개 변수에 FILE_SHARE_READ 및 FILE_SHARE_WRITE 플래그를 지정해야 합니다.

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

기술	지원
SMB(서버 메시지 블록) 3.0 프로토콜	아니요
SMB 3.0 TFO(투명한 장애 조치(failover)	아니요
SO(스케일 아웃 파일 공유)가 있는 SMB 3.0	아니요
CsvFS(클러스터 공유 볼륨 파일 시스템)	메모 보기

 

PNP 알림은 FSCTL이 발급된 노드에서만 발급됩니다.

CSV 볼륨에 대한 잠금을 획득한 후 볼륨에 대한 핸들을 열기 전에 해당 볼륨을 잠그는 데 사용되는 핸들을 닫아야 합니다. FSCTL_UNLOCK_VOLUME 사용하여 볼륨을 잠금 해제하는 것으로는 충분하지 않습니다.

요구 사항

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

참고 항목

CreateFile

DeviceIoControl

FSCTL_LOCK_VOLUME

볼륨 관리 제어 코드