IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (winioctl.h)

  • Article

Efface toutes les informations de cliché instantané (également appelées « instantané ») matériel du service VSS (Volume Shadow Copy Service) du disque.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Remarques

Le disque dont le handle est utilisé lors de l’émission de ce IOCTL peut être dans l’état hors connexion lors de l’émission de l’IOCTL. Si le disque est mis en mode hors connexion à l’aide du composant logiciel enfichable Microsoft Management Console (MMC) de gestion des disques, son attribut en lecture seule est défini sur le disque, ce qui entraîne l’échec de cet IOCTL. Toutefois, si l’utilitaire de partition de disque (Diskpart.exe) est utilisé pour placer le disque dans l’état hors connexion, l’attribut en lecture seule du disque n’est pas défini. Pour cette raison, il est préférable d’utiliser l’utilitaire de partition de disque pour placer un disque dans l’état hors connexion.

Notes

 L’un des effets secondaires de l’utilisation de cet IOCTL est que les outils de gestion des disques signalent désormais une partition supplémentaire sur les disques GPT de type « UNKNOWN ». Cette partition de 256 Ko est créée à l’aide d’IOCTL et est la partition de cliché instantané utilisée dans le processus de restauration. La partition est attendue et peut être ignorée par les administrateurs système.

Configuration requise

   
En-tête winioctl.h (inclure Windows.h)

Voir aussi