FSCTL_UNLOCK_VOLUME IOCTL (winioctl.h)
Entsperrt ein Volume.
Rufen Sie zum Ausführen dieses Vorgangs die DeviceIoControl--Funktion 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 wird auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist.
Andernfalls ist status to the appropriate error condition as a NTSTATUS code.
Weitere Informationen finden Sie unter NTSTATUS Values.
Bemerkungen
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. Rufen Sie zum Abrufen dieses Handle CreateFile- auf, wobei der parameter lpFileName auf eine Zeichenfolge des folgenden Formulars festgelegt ist:
\\.\X-:
dabei ist X- ein Festplattenpartitionsbuchstaben, Diskettenlaufwerk oder CD-ROM Laufwerk. 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 | Abgestützt |
|---|---|
| Server Message Block (SMB) 3.0-Protokoll | Nein |
| SMB 3.0 Transparent Failover (TFO) | Nein |
| SMB 3.0 mit Skalierungsdateifreigaben (SO) | Nein |
| Freigegebenes Clustervolumedateisystem (CsvFS) | Kommentar anzeigen |
Die PNP-Benachrichtigung wird nur auf dem Knoten ausgegeben, auf dem die FSCTL ausgestellt wurde.
Nach dem Abrufen einer Sperre auf einem CSV-Volume müssen Sie den Handle schließen, der zum Sperren dieses Volumes verwendet wird, bevor Sie ein Handle für das Volume öffnen. Das Entsperren des Volumes mithilfe von FSCTL_UNLOCK_VOLUME reicht nicht aus.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Header- | winioctl.h (enthalten Windows.h) |