IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

Limpa todas as informações de instantâneo baseadas em hardware do VSS (serviço de cópia de sombra de volume) do disco. Um instantâneo também é conhecido como uma cópia de sombra. Essa solicitação está disponível no Windows Vista e em versões posteriores dos sistemas operacionais Windows. O chamador deve estar em execução no IRQL = PASSIVE_LEVEL.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

Bloco de status

O membro de Informações do está definido como zero. O membro Status será definido como STATUS_SUCCESS se a operação tiver sido bem-sucedida. Caso contrário, o membro status do é definido como o código de erro apropriado.

Observações

Esse código de controle de E/S pode ser emitido de um driver do modo kernel ou de um aplicativo de modo de usuário. Quando esse código de controle de E/S é emitido de um driver no modo kernel, o chamador fornece um IRP (Pacote de Solicitação de E/S) que contém uma estrutura de dados IO_STATUS_BLOCK. Essa estrutura de dados é usada para retornar informações de erro ao chamador. Quando esse código de controle de E/S é emitido de um aplicativo de modo de usuário com a rotina de DeviceIocontrol, o chamador pode obter informações de erro chamando a rotina de getLastError.

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 do MMC (Console de Gerenciamento da Microsoft) do gerenciador de discos, 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 do 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.

Requisitos