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 Нет
Прозрачная отработка отказа (TFO) SMB 3.0 Нет
SMB 3.0 с масштабируемыми общими папками (SO) Нет
Файловая система общего тома кластера (CSVFS) Нет

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть winioctl.h (включая Windows.h)

См. также раздел