IOCTL_VOLUME_IS_CLUSTERED IOCTL (winioctl.h)

  • Статья

Определяет, является ли указанный том кластеризованным.

Для выполнения этой операции вызовите функцию DeviceIoControl со следующими параметрами.

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

Комментарии

Код элемента управления IOCTL_VOLUME_IS_CLUSTERED действителен, только если запущена служба кластеров.

Ошибка ERROR_GEN_FAILURE указывает, что компьютер, на котором в настоящее время находится диск, на котором находится том, является узлом кластера сервера, но диск является ресурсом физического диска, который в настоящее время находится в автономном состоянии, или диск не является ресурсом физического диска. Чтобы определить, какая из этих ситуаций существует, выполните следующие действия.

  1. Вызовите функцию ClusterEnum , чтобы перечислить все ресурсы физического диска в кластере.
  2. Выполните поиск тома для каждого перечисленного ресурса физического диска, вызвав функцию ClusterResourceControl с CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO. Если не удается найти том среди ресурсов физического диска в кластере, том не находится на ресурсе физического диска.

Ошибка ERROR_INVALID_FUNCTION указывает, что компьютер, на котором в данный момент находится том, не является узлом кластера сервера или диск не является ресурсом физического диска. Чтобы определить, является ли компьютер узлом кластера сервера, вызовите функцию GetNodeClusterState .

В 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)

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