IOCTL_VOLUME_OFFLINE IOCTL (winioctl.h)
Met un volume hors connexion.
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_OFFLINE, // dwIoControlCode
NULL, // lpInBuffer
0, // nInBufferSize
NULL, // lpOutBuffer
0, // nOutBufferSize
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped // OVERLAPPED structure
);
Remarques
Les applications doivent d’abord démonter correctement le système de fichiers via FSCTL_DISMOUNT_VOLUME avant d’utiliser IOCTL_VOLUME_OFFLINE.
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 à l’aide du même handle de volume que celui utilisé pour le démontage empêche le montage du volume démonté d’être monté à nouveau.
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 en ligne, utilisez le code de contrôle IOCTL_VOLUME_ONLINE .
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) |