Método IVdsPack::AddDisk (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.]

Agrega un disco a un paquete en línea.

Sintaxis

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

Parámetros

[in] DiskId

GUID del disco.

[in] PartitionStyle

El estilo puede ser MBR o GPT. Consulte la enumeración VDS_PARTITION_STYLE .

[in] bAsHotSpare

Si es true, VDS puede usar el disco como reserva activa; de lo contrario, no se puede usar el disco para esta operación. Solo los proveedores de hardware admiten la moderación activa.

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
 El disco se agregó correctamente.
VDS_E_NOT_AN_UNALLOCATED_DISK
0x80042418L
 El disco es sin procesar.
VDS_E_OPERATION_DENIED
0x8004240AL
 El disco que se va a agregar se está limpiando.
VDS_E_PROVIDER_FAILURE
0x80042442L
 Hay un error de proveedor durante la operación.
VDS_E_NOT_SUPPORTED
0x80042400L
 No se admite la adición de un segundo disco a un paquete básico.
VDS_E_PACK_OFFLINE
0x80042444L
 No se puede acceder al paquete de destino.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 No se encuentra el disco.
VDS_E_DMADMIN_METHOD_CALL_FAILED
0x80042420L
 El servicio del administrador de discos lógicos (LDM) no pudo completar un método.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 La caché del proveedor dinámico está dañada.

Comentarios

VDS implementa este método.

Este método inicializa un disco sin procesar (un disco que no tiene ninguna creación de particiones definida) y lo agrega al paquete. Antes de llamar a este método, el disco sin formato es propiedad del servicio VDS. Una vez devuelto este método, el disco es propiedad del proveedor básico.

Para deshacer el efecto de este método, es decir, para quitar el formato de creación de particiones y hacer que el disco sea un disco sin formato que sea propiedad del servicio VDS, use el método IVdsAdvancedDisk::Clean .

No puede usar AddDisk para volver a definir la creación de particiones en un disco existente.

Si agrega un disco GPT a un paquete básico, la operación crea automáticamente una partición MSR en el disco. Los dispositivos que ejecutan el sistema operativo WinPE son la excepción porque un administrador podría preferir crear una partición ESP en el disco. La partición ESP, si está presente, debe ser la primera partición del disco.

Si agrega el disco a un paquete dinámico, la operación no crea una partición MSR.

Requisitos

Requisito Value
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

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE