IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (winioctl.h)

  • Artikel

Löscht alle hardwarebasierten Informationen zu Schattenkopien des Volume Shadow Copy Service (VSS) (auch als „Snapshot“ bezeichnet) vom Datenträger.

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to device
  IOCTL_DISK_RESET_SNAPSHOT_INFO,   // dwIoControlCode
  NULL,                             // lpInBuffer
  0,                                // nInBufferSize
  NULL,                             // lpOutBuffer
  0,                                // nOutBufferSize
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

Hinweise

Der Datenträger, dessen Handle verwendet wird, wenn diese IOCTL ausgestellt wird, befindet sich möglicherweise im Offlinezustand, wenn die IOCTL ausgestellt wird. Wenn der Datenträger mithilfe des MMC-Snap-Ins (Microsoft Management Console) für die Datenträgerverwaltung in den Offlinezustand versetzt wird, ist für den Datenträger sein schreibgeschütztes Attribut festgelegt, was dazu führt, dass diese IOCTL fehlschlägt. Wenn jedoch das Festplattenpartitionshilfsprogramm (Diskpart.exe) verwendet wird, um den Datenträger in den Offlinezustand zu versetzen, wird das schreibgeschützte Attribut für den Datenträger nicht festgelegt. Aus diesem Grund empfiehlt es sich, das Festplattenpartitionshilfsprogramm zu verwenden, um einen Datenträger in den Offlinezustand zu versetzen.

Hinweis

 Ein Nebeneffekt der Verwendung dieser IOCTL ist, dass die Datenträgerverwaltungstools jetzt eine zusätzliche Partition auf GPT-Datenträgern vom Typ "UNKNOWN" melden. Diese Partition mit 256 KB wird mithilfe des IOCTL erstellt und ist die Schattenkopiepartition, die beim Wiederherstellungsvorgang verwendet wird. Die Partition wird erwartet und kann von Systemadministratoren ignoriert werden.

Anforderungen

   
Kopfzeile winioctl.h (einschließlich Windows.h)

Weitere Informationen