Método IVdsVolumeMF3::OfflineVolume (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.]
Desconecta el volumen mediante el código de control IOCTL_VOLUME_OFFLINE .
Sintaxis
HRESULT OfflineVolume();
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 devuelto | Descripción |
|---|---|
|
El método se completó correctamente. |
Comentarios
Si el volumen ya está sin conexión, el método OfflineVolume devuelve S_OK.
Cuando un volumen está sin conexión, todas las solicitudes de lectura, escritura e IOCTL producen un error ERROR_NOT_READY. No se puede desconectar el sistema o el volumen de arranque.
Cuando un volumen está en línea, se respetan todas las solicitudes enviadas al volumen.
Cuando se desmonta un volumen que está en línea, la siguiente llamada para abrir el volumen hace que se monte. Desconectar el volumen impide que el volumen desmontado se vuelva a montar. Para desmontar un volumen, use el método IVdsVolumeMF::D ismount .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vds.h |
| Library | Uuid.lib |