Partager via

FSCTL_UNLOCK_VOLUME IOCTL (winioctl.h)

  • Article

Déverrouille un volume.

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

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

Irp->IoStatus.Status est défini sur STATUS_SUCCESS si la demande réussit.

Sinon, état à la condition d’erreur appropriée en tant que code NTSTATUS.

Pour plus d’informations, consultez valeurs NTSTATUS.

Remarques

Pour verrouiller un volume, utilisez le code de contrôle FSCTL_LOCK_VOLUME.

Le handle hDevice transmis à DeviceIoControl doit être un handle vers un volume, ouvert pour un accès direct. Pour récupérer ce handle, appelez CreateFile avec le paramètre lpFileName défini sur une chaîne du formulaire suivant :

\\.\X:

où X est une lettre de partition de disque dur, un lecteur de disque floppy ou un lecteur CD-ROM. L’application doit également spécifier les indicateurs FILE_SHARE_READ et FILE_SHARE_WRITE dans le paramètre dwShareMode de CreateFile.

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

Technologie Supporté
Protocole SMB (Server Message Block) 3.0 Non
Basculement transparent SMB 3.0 (TFO) Non
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) Non
Cluster Shared Volume File System (CsvFS) Voir le commentaire
 

La notification PNP n’est émise que sur le nœud où le FSCTL a été émis.

Après avoir acquis un verrou sur un volume CSV, vous devez fermer le handle utilisé pour verrouiller ce volume avant d’ouvrir un handle sur le volume. Le déverrouillage du volume à l’aide de FSCTL_UNLOCK_VOLUME n’est pas suffisant.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
d’en-tête winioctl.h (include Windows.h)

Voir aussi

CreateFile

DeviceIoControl

FSCTL_LOCK_VOLUME

codes de contrôle de gestion des volumes