FSCTL_UNLOCK_VOLUME IOCTL (winioctl.h)

  • Artikel

Entsperrt ein Volume.

Um diesen Vorgang auszuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.

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> ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist.

Andernfalls wird status für die entsprechende Fehlerbedingung als NTSTATUS-Code verwendet.

Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Um ein Volume zu sperren, verwenden Sie den FSCTL_LOCK_VOLUME-Steuercode.

Das hDevice-Handle , das an DeviceIoControl übergeben wird, muss ein Handle für ein Volume sein, das für den direkten Zugriff geöffnet wird. Um dieses Handle abzurufen, rufen Sie CreateFile auf, wobei der lpFileName-Parameter auf eine Zeichenfolge der folgenden Form festgelegt ist:

\.\X:

wobei X ein Festplattenpartitionsbuchstaben, Diskettenlaufwerk oder CD-ROM-Laufwerk ist. Die Anwendung muss auch die FILE_SHARE_READ - und FILE_SHARE_WRITE-Flags im dwShareMode-Parameter von CreateFile angeben.

IIn Windows 8 und Windows Server 2012 wird dieser Code von den folgenden Technologien unterstützt.

Technologie Unterstützt
SMB 3.0-Protokoll (Server Message Block) No
SMB 3.0 Transparent Failover (TFO) No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) No
Dateisystem mit freigegebenen Clustervolumes (CsvFS) Siehe Kommentar
 

Die PNP-Benachrichtigung wird nur auf dem Knoten ausgegeben, auf dem die FSCTL ausgestellt wurde.

Nachdem Sie eine Sperre für ein CSV-Volume erworben haben, müssen Sie den Zum Sperren dieses Volumes verwendeten Handle schließen, bevor Sie ein Handle für das Volume öffnen. Das Entsperren des Volumes mithilfe von FSCTL_UNLOCK_VOLUME reicht nicht aus.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (einschließlich Windows.h)

Weitere Informationen

CreateFile

DeviceIoControl

FSCTL_LOCK_VOLUME

Volumeverwaltungs-Steuerungscodes