IOCTL_VOLUME_IS_CLUSTERED IOCTL (winioctl.h)

  • Article

Détermine si le volume spécifié est en cluster.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Remarques

Le code de contrôle IOCTL_VOLUME_IS_CLUSTERED est valide uniquement si le service de cluster est en cours d’exécution.

L’erreur ERROR_GEN_FAILURE indique que l’ordinateur qui possède actuellement le disque sur lequel réside le volume est un nœud de cluster de serveurs, mais que le disque est une ressource de disque physique actuellement en mode hors connexion ou que le disque n’est pas une ressource de disque physique. Pour déterminer laquelle de ces situations existe, procédez comme suit :

  1. Appelez la fonction ClusterEnum pour énumérer toutes les ressources de disque physique dans le cluster.
  2. Recherchez le volume dans chaque ressource disque physique énumérée en appelant la fonction ClusterResourceControl avec CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO. Si vous ne trouvez pas le volume parmi les ressources de disque physique dans le cluster, le volume ne réside pas sur une ressource de disque physique.

L’erreur ERROR_INVALID_FUNCTION indique que l’ordinateur qui possède actuellement le disque sur lequel réside le volume n’est pas un nœud de cluster de serveurs ou que le disque n’est pas une ressource de disque physique. Pour déterminer si un ordinateur est un nœud de cluster de serveurs, appelez la fonction GetNodeClusterState .

Dans Windows 8 et Windows Server 2012, ce code est pris en charge par les technologies suivantes.

Technologie Prise en charge
Protocole Server Message Block (SMB) 3.0 No
Basculement transparent SMB 3.0 (TFO) No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) No
Système de fichiers du volume partagé de cluster (CsvFS) Oui

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi