IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

  • Artículo

Borra toda la información de instantáneas del servicio de instantáneas de volumen (VSS) del disco. Una instantánea también se conoce como instantánea. Esta solicitud está disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. El autor de la llamada debe ejecutarse en IRQL = PASSIVE_LEVEL.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Ninguno.

Longitud del búfer de entrada

Ninguno.

Búfer de salida

Ninguno.

Longitud del búfer de salida

Ninguno.

Bloque de estado

El miembro Information se establece en cero. El miembro Status se establece en STATUS_SUCCESS si la operación se realizó correctamente. De lo contrario, el miembro Status se establece en el código de error adecuado.

Comentarios

Este código de control de E/S se puede emitir desde un controlador en modo kernel o desde una aplicación en modo de usuario. Cuando se emite este código de control de E/S desde un controlador en modo kernel, el autor de la llamada proporciona un paquete de solicitud de E/S (IRP) que contiene una estructura de datos IO_STATUS_BLOCK. Esta estructura de datos se usa para devolver información de error al autor de la llamada. Cuando este código de control de E/S se emite desde una aplicación en modo de usuario con la rutina DeviceIocontrol , el autor de la llamada puede obtener información de error llamando a la rutina GetLastError .

El disco cuyo identificador se usa cuando se emite este IOCTL podría estar en estado sin conexión cuando se emite el IOCTL. Si el disco se coloca en estado sin conexión mediante el complemento Microsoft Management Console (MMC) del administrador de discos, el disco tendrá establecido su atributo de solo lectura, lo que hará que se produzca un error en este IOCTL. Sin embargo, si la utilidad de partición de disco (Diskpart.exe) se usa para colocar el disco en estado sin conexión, no se establece el atributo de solo lectura del disco. Por este motivo, es mejor usar la utilidad de partición de disco para colocar un disco en estado sin conexión.

Nota Un efecto secundario del uso de este IOCTL es que las herramientas de administración de discos pueden notificar una partición adicional del tipo "UNKNOWN" en discos GPT. La operación IOCTL crea esta partición de 256 kilobytes y es una partición de instantánea que se usa en el proceso de restauración. Se espera esta partición y los administradores del sistema pueden omitirla.
 

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows Vista.
Encabezado ntdddisk.h (include Ntdddisk.h)
IRQL PASSIVE_LEVEL