IOCTL_VOLUME_IS_CLUSTERED IOCTL (winioctl.h)

  • Artículo

Determina si el volumen especificado está agrupado.

Para realizar esta operación, llame a la función DeviceIoControl con los siguientes parámetros.

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

Comentarios

El código de control IOCTL_VOLUME_IS_CLUSTERED solo es válido si se está ejecutando el servicio de clúster.

El error ERROR_GEN_FAILURE indica que el equipo que posee actualmente el disco en el que reside el volumen es un nodo de clúster de servidor, pero el disco es un recurso de disco físico actualmente en un estado sin conexión o que el disco no es un recurso de disco físico. Para determinar cuál de estas situaciones existe, siga estos pasos:

  1. Llame a la función ClusterEnum para enumerar todos los recursos de disco físico del clúster.
  2. Busque en cada recurso de disco físico enumerado para el volumen mediante una llamada a la función ClusterResourceControl con CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO. Si no encuentra el volumen entre los recursos de disco físico del clúster, el volumen no reside en un recurso de disco físico.

El error ERROR_INVALID_FUNCTION indica que el equipo que posee actualmente el disco en el que reside el volumen no es un nodo de clúster de servidor o que el disco no es un recurso de disco físico. Para determinar si un equipo es un nodo de clúster de servidores, llame a la función GetNodeClusterState .

En Windows 8 y Windows Server 2012, este código es compatible con las siguientes tecnologías.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) Sí

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluye Windows.h)

Consulte también