Método IVdsAdvancedDisk::Clean (vds.h)
[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 |
|---|---|
|
Los datos se quitaron correctamente y el disco no se inicializó. |
|
No hay ningún medio en el dispositivo extraíble. |
|
Falta el disco. |
|
Se produjo un error en la operación en una de las condiciones siguientes:
|
|
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 |