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.

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

Siehe auch

CreateFile-

DeviceIoControl-

FSCTL_LOCK_VOLUME

Volume Management Control Codes