IOCTL_VOLUME_ONLINE IOCTL (winioctl.h)

  • Artikel

Stellt ein Volume online.

Windows Server 2003 und Windows XP: Dieser Steuercode 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_ONLINE,          // dwIoControlCode
  NULL,                         // lpInBuffer
  0,                            // nInBufferSize
  NULL,                         // lpOutBuffer
  0,                            // nOutBufferSize
  (LPDWORD) lpBytesReturned,    // number of bytes returned
  (LPOVERLAPPED) lpOverlapped   // OVERLAPPED structure
);

Hinweise

Wenn ein Volume offline ist, schlagen alle Lese-, Schreib- und IOCTL-Anforderungen mit ERROR_NOT_READY fehl. Sie können das System- oder Startvolume nicht offline schalten.

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

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

Um ein Volume offline zu schalten, verwenden Sie den IOCTL_VOLUME_OFFLINE Steuercode.

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 (windows.h einschließen)

Weitere Informationen