IOCTL_VOLUME_OFFLINE IOCTL (winioctl.h)

  • Artikel

Nimmt ein Volume offline.

Windows Server 2003 und Windows XP: Dieser Steuerelementcode wird für dynamische Datenträger nicht unterstützt.

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

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
);

Hinweise

Anwendungen müssen zuerst die Bereitstellung des Dateisystems über FSCTL_DISMOUNT_VOLUME erfolgreich aufheben, bevor sie IOCTL_VOLUME_OFFLINE verwenden.

Wenn ein Volume, das online ist, nicht bereitgestellt wird, wird es beim nächsten Aufruf zum Öffnen des Volumes eingebunden. Wenn das Volume mit demselben Volumehandle offline geschaltet wird, das für die Demontage verwendet wurde, wird verhindert, dass das nicht bereitgestellte Volume erneut eingebunden wird.

Wenn ein Volume online ist, werden alle an das Volume gesendeten Anforderungen berücksichtigt.

Wenn ein Volume, das online ist, nicht bereitgestellt wird, wird es beim nächsten Aufruf zum Öffnen des Volumes eingebunden. Wenn Sie das Volume offline schalten, wird verhindert, dass das nicht bereitgestellte Volume erneut eingebunden wird.

Um ein Volume online zu schalten, verwenden Sie den IOCTL_VOLUME_ONLINE-Steuerungscode.

In 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) No

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