Compartir a través de

Método IVdsAdvancedDisk::Clean (vds.h)

  • Artículo

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Quita la información de partición y anula la inicialización de los discos básicos o dinámicos.

Windows Server 2003: El método Clean no se admite para dispositivos extraíbles.

Sintaxis

HRESULT Clean(
  [in]  BOOL      bForce,
  [in]  BOOL      bForceOEM,
  [in]  BOOL      bFullClean,
  [out] IVdsAsync **ppAsync
);

Parámetros

[in] bForce

Si es TRUE, limpia un disco que contiene volúmenes de datos o particiones ESP.

[in] bForceOEM

Si es TRUE, limpia un disco basado en MBR que contiene las particiones oem conocidas en la tabla siguiente o limpia un disco basado en GPT que contenga cualquier partición OEM. Una partición oem tiene la marca GPT_ATTRIBUTE_PLATFORM_REQUIRED establecida en un disco basado en GPT.

Tipo de partición Descripción
0x12 Una partición EISA.
0x84 Partición de hibernación para portátiles.
0xA0 Una partición de diagnóstico para algunos equipos portátiles hp.
0xDE Partición definida por Dell.
0xFE Una partición de IBM IML.

[in] bFullClean

Si es TRUE, limpia todo el disco reemplazando los datos de cada sector por ceros; de lo contrario, este método limpia solo los primeros y los últimos megabytes en el disco.

[out] ppAsync

La dirección de un puntero al puntero de interfaz IVdsAsync , que VDS inicializa al devolver. Los autores de llamadas deben liberar la interfaz. Use este puntero para cancelar, esperar o consultar el estado de la operación.

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores se pueden originar en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los posibles valores devueltos se incluyen los siguientes.

Código o valor devuelto Descripción
S_OK
 Los datos se quitaron correctamente y el disco no se inicializó.
VDS_E_NO_MEDIA
0x80042412L
 No hay ningún medio en el dispositivo extraíble.
VDS_E_MISSING_DISK
0x80042454L
 Falta el disco.
VDS_E_OPERATION_DENIED
0x8004240AL
 Se produjo un error en la operación en una de las condiciones siguientes:
  • El disco contiene una partición OEM y bForceOEM es false.
  • El disco contiene un volumen o una partición ESP y bForce es FALSE.
  • El disco contiene uno de los volúmenes del sistema independientemente de si bForce es TRUE o FALSE. Un volumen del sistema puede ser cualquiera de los siguientes elementos:
    • Un volumen que contiene el cargador del sistema operativo.
    • Un volumen de arranque, que contiene el directorio system32.
    • Un volumen que contiene el archivo pagefile o hibernación, o un volumen que se usa como volcado de memoria.
    • Una partición ESP (la partición desde la que arranca el sistema).
VDS_S_DISK_PARTIALLY_CLEANED
0x0004241AL
 La tabla de particiones se limpia, pero no todos los sectores se limpian durante una limpieza completa. Como alternativa, algunos sectores del primer megabyte y el último megabyte están limpios; sin embargo, a menos que la limpieza sea una limpieza completa, los sectores restantes no se limpian.

Comentarios

Antes de llamar a este método, el autor de la llamada debe desmontar los volúmenes montados en el disco mediante una llamada a IVdsVolumeMF::D ismount para cada volumen.

Use el parámetro bForce , el parámetro bForceOEM o ambos con este método, a menos que elimine primero todos los volúmenes de datos, las particiones OEM conocidas y las particiones ESP en el disco. Este requisito excluye las particiones de metadatos, como MSR, la partición de metadatos LDM y las particiones de OEM desconocidas.

Windows Server 2003: El método Clean no se admite para dispositivos extraíbles.

Los implementadores deben devolver un puntero a la interfaz IVdsAsync de este método, independientemente de si la llamada inicia una operación asincrónica.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vds.h
Library Uuid.lib

Consulte también

Disk (objeto)

IVdsAdvancedDisk

IVdsAsync