IOCTL_VOLUME_OFFLINE IOCTL(winioctl.h)

  • 아티클

볼륨을 오프라인 상태로 전환합니다.

Windows Server 2003 및 Windows XP: 이 제어 코드는 동적 디스크에 대해 지원되지 않습니다.

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

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

설명

애플리케이션은 먼저 IOCTL_VOLUME_OFFLINE 사용하기 전에FSCTL_DISMOUNT_VOLUME 통해 파일 시스템을 성공적으로 분리해야 합니다.

온라인 볼륨이 분리되면 볼륨을 열기 위한 다음 호출로 인해 볼륨이 탑재됩니다. 분리에 사용된 것과 동일한 볼륨 핸들을 사용하여 볼륨을 오프라인으로 전환하면 분리된 볼륨이 다시 탑재되지 않습니다.

볼륨이 온라인 상태이면 볼륨으로 전송된 모든 요청이 적용됩니다.

온라인 볼륨이 분리되면 볼륨을 열기 위한 다음 호출로 인해 볼륨이 탑재됩니다. 볼륨을 오프라인으로 전환하면 분리된 볼륨이 다시 탑재되지 않습니다.

볼륨을 온라인 상태로 만들려면 IOCTL_VOLUME_ONLINE 제어 코드를 사용합니다.

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

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

요구 사항

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

추가 정보