Skip to content

Latest commit

 

History

History
166 lines (128 loc) · 5.93 KB

nf-vds-ivdsmaintenance-startmaintenance.md

File metadata and controls

166 lines (128 loc) · 5.93 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:vds.IVdsMaintenance.StartMaintenance
IVdsMaintenance::StartMaintenance (vds.h)
The IVdsMaintenance::StartMaintenance method (vds.h) starts a maintenance operation.
IVdsMaintenance interface [VDS]
StartMaintenance method
IVdsMaintenance.StartMaintenance
IVdsMaintenance::StartMaintenance
StartMaintenance
StartMaintenance method [VDS]
StartMaintenance method [VDS]
IVdsMaintenance interface
base.ivdsmaintenance_startmaintenance
vds/IVdsMaintenance::StartMaintenance
vdshwprv/IVdsMaintenance::StartMaintenance
base\ivdsmaintenance_startmaintenance.htm
base
8d2e1022-ae79-4f71-a488-2c86b43b2a7f
08/05/2022
IVdsMaintenance interface [VDS],StartMaintenance method, IVdsMaintenance.StartMaintenance, IVdsMaintenance::StartMaintenance, StartMaintenance, StartMaintenance method [VDS], StartMaintenance method [VDS],IVdsMaintenance interface, base.ivdsmaintenance_startmaintenance, vds/IVdsMaintenance::StartMaintenance, vdshwprv/IVdsMaintenance::StartMaintenance
vds.h
Windows
Windows Vista [desktop apps only]
Windows Server 2003 [desktop apps only]
Uuid.lib
Windows
19H1
IVdsMaintenance::StartMaintenance
vds/IVdsMaintenance::StartMaintenance
c++
APIRef
kbSyntax
COM
Uuid.lib
Uuid.dll
IVdsMaintenance.StartMaintenance

IVdsMaintenance::StartMaintenance

-description

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Starts a maintenance operation.

-parameters

-param operation [in]

A maintenance operation enumerated by VDS_MAINTENANCE_OPERATION.

-returns

This method can return standard HRESULT values, such as E_INVALIDARG or E_OUTOFMEMORY, and VDS-specific return values. It can also return converted system error codes using the HRESULT_FROM_WIN32 macro. Errors can originate from VDS itself or from the underlying VDS provider that is being used. Possible return values include the following.

Return code/value Description
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
This return value signals a software or communication problem inside a provider that caches information about the array. Use the IVdsHwProvider::Reenumerate method followed by the IVdsHwProvider::Refresh method to restore the cache.
VDS_E_OBJECT_DELETED
0x8004240BL

The subsystem object is no longer present.

VDS_E_OBJECT_STATUS_FAILED
0x80042431L
The subsystem is in a failed state, and is unable to perform the requested operation.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
Another operation is in progress; this operation cannot proceed until the previous operation or operations are complete.
VDS_E_NOT_SUPPORTED
0x80042400L
This operation or combination of parameters is not supported by this provider.

-remarks

Once an operation begins, it runs until the caller invokes either the StopMaintenance method or the PulseMaintenance method. When StopMaintenance is called on a running operation, the operation stops immediately. When PulseMaintenance is called on a running operation, the operation pulses the specified number of times and then stops.

Calling StartMaintenance on a pulsing operation causes the operation to start and run until either StopMaintenance is called to stop it or PulseMaintenance is called to set it pulsing it again.

-see-also

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsMaintenance

IVdsMaintenance::PulseMaintenance

IVdsMaintenance::StopMaintenance

VDS_MAINTENANCE_OPERATION