Método IVdsServiceUninstallDisk::UninstallDisks (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.]
Desinstala un conjunto de discos.
Sintaxis
HRESULT UninstallDisks(
[in] VDS_OBJECT_ID *pDiskIdArray,
[in] ULONG ulCount,
[in] BOOLEAN bForce,
[out] BOOLEAN *pbReboot,
[out] HRESULT *pResults
);
Parámetros
[in] pDiskIdArray
Dirección de un búfer que contiene una matriz de identificadores de objeto VDS, uno para cada disco que se va a desinstalar. Cada identificador de la matriz debe ser único.
[in] ulCount
Número de identificadores de objeto de VDS en el búfer al que apunta el parámetro pDiskIdArray .
[in] bForce
Si es TRUE, VDS desinstala los discos incluso si los volúmenes no se pueden bloquear ni desmontar.
[out] pbReboot
Dirección de una variable BOOLEAN que recibe TRUE si el usuario debe reiniciar el equipo para completar el proceso de desinstalación.
[out] pResults
Dirección de una matriz asignada por el autor de la llamada de valores HRESULT . El número de elementos de la matriz apunta al parámetro pDiskIdArray . El primer elemento de esta matriz corresponde al primer elemento de pDiskIdArray, etc. Si alguno de los discos no se inicializa correctamente, se devuelve el código de error específico del error en el elemento correspondiente de esta matriz.
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 discos se desinstalaron correctamente. |
|
Este método devolvió una advertencia o código de error para uno o varios discos. |
|
Los discos se desinstalaron correctamente, pero no se pudieron recuperar los atributos de la tabla de particiones GUID (GPT) para uno o varios discos. |
|
VDS encontró un error interno. Compruebe el registro de eventos para obtener más información. |
|
Faltaban uno o más discos. |
|
No se pudo recuperar la ruta de acceso para uno o varios discos. |
|
No se pudo recuperar la ruta de acceso para uno o varios volúmenes. |
|
Uno o varios de los identificadores de objeto de VDS especificados corresponden a discos que ya no están presentes. |
|
Uno o varios de los identificadores de objeto de VDS especificados corresponden a los discos que no existen. |
|
La caché del proveedor no está sincronizada con la caché del controlador. |
Comentarios
VDS implementa este método.
Este método, que es sincrónico, primero desinstala los volúmenes de los discos especificados y, a continuación, desinstala los discos. Una vez desinstalados los discos, los LUN correspondientes se pueden enmascarar (ocultar) o eliminar.
Este método limpia las letras de unidad asignadas a los volúmenes de los discos. Además, establece los volúmenes sin conexión para evitar que se vuelva a montar un volumen después de cerrar el identificador de desmontaje, pero antes de que se quite realmente el disco.
Al quitar un volumen dinámico que abarque más de un disco, debe llamar a este método en lugar de usar funciones de administrador de dispositivos.
Para obtener instrucciones sobre cómo desinstalar un disco en versiones de Windows Server 2003 en las que no se admite el método UninstallDisks , vea la sección Comentarios del método IVdsLun::SetMask .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vds.h |
| Library | Uuid.lib |