Método IVdsMaintenance::StartMaintenance (vdshwprv.h)

Artículo
03/08/2023

[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.]

Inicia una operación de mantenimiento.

Sintaxis

HRESULT StartMaintenance(
  [in] VDS_MAINTENANCE_OPERATION operation
);

Parámetros

[in] operation

Una operación de mantenimiento enumerada por VDS_MAINTENANCE_OPERATION.

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
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Este valor devuelto indica un problema de software o comunicación dentro de un proveedor que almacena en caché información sobre la matriz. Use el método IVdsHwProvider::Reenumerate seguido del método IVdsHwProvider::Refresh para restaurar la memoria caché.
VDS_E_OBJECT_DELETED 0x8004240BL	El objeto del subsistema ya no está presente.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	El subsistema está en un estado de error y no puede realizar la operación solicitada.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Otra operación está en curso; esta operación no puede continuar hasta que se completen las operaciones o operaciones anteriores.
VDS_E_NOT_SUPPORTED 0x80042400L	Este proveedor no admite esta operación o combinación de parámetros.

Comentarios

Una vez que se inicia una operación, se ejecuta hasta que el autor de la llamada invoca el método StopMaintenance o el método PulseMaintenance . Cuando se llama a StopMaintenance en una operación en ejecución, la operación se detiene inmediatamente. Cuando se llama a PulseMaintenance en una operación en ejecución, la operación pulsa el número de veces especificado y, a continuación, se detiene.

Llamar a StartMaintenance en una operación de pulsificación hace que la operación se inicie y se ejecute hasta que se llame a StopMaintenance para detenerlo o se llame a PulseMaintenance para establecerlo de nuevo.

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	vdshwprv.h
Library	Uuid.lib