Partager via

IOCTL_VOLUME_ONLINE IOCTL (winioctl.h)

  • Article

Met un volume en ligne.

Windows Server 2003 et Windows XP : Ce code de contrôle n’est pas pris en charge pour les disques dynamiques.

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

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

Remarques

Lorsqu’un volume est hors connexion, toutes les demandes de lecture, d’écriture et IOCTL échouent avec ERROR_NOT_READY. Vous ne pouvez pas mettre le système ou le volume de démarrage hors connexion.

Lorsqu’un volume est en ligne, toutes les demandes envoyées au volume sont honorées.

Lorsqu’un volume en ligne est démonté, l’appel suivant pour ouvrir le volume entraîne son montage. La mise hors connexion du volume empêche le montage du volume démonté.

Pour mettre un volume hors connexion, utilisez le code de contrôle IOCTL_VOLUME_OFFLINE .

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

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