IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (winioctl.h)

  • Artigo

Limpa todas as informações de cópia de sombra baseadas em hardware do VSS (Serviço de Cópias de Sombra de Volume) (também chamada de "instantâneo") do disco.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

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

Comentários

O disco cujo identificador é usado quando esse IOCTL é emitido pode estar no estado offline quando o IOCTL é emitido. Se o disco for colocado no estado offline usando o snap-in MMC (Console de Gerenciamento da Microsoft) de gerenciamento de disco, o disco terá seu atributo somente leitura definido, o que fará com que esse IOCTL falhe. No entanto, se o utilitário de partição de disco (Diskpart.exe) for usado para colocar o disco no estado offline, o atributo somente leitura para o disco não será definido. Por esse motivo, é melhor usar o utilitário de partição de disco para colocar um disco no estado offline.

Observação

 Um efeito colateral do uso desse IOCTL é que as ferramentas de Gerenciamento de Disco agora relatarão uma partição adicional em discos GPT do tipo "UNKNOWN". Essa partição de 256 KB é criada usando o IOCTL e é a partição de cópia de sombra usada no processo de restauração. A partição é esperada e pode ser ignorada pelos administradores do sistema.

Requisitos

   
Cabeçalho winioctl.h (inclua Windows.h)

Confira também