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.

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

Consulte también

IVdsServiceUninstallDisk