Skip to content

Latest commit

 

History

History
164 lines (135 loc) · 5.01 KB

nf-vds-ivdssubsystem-setstatus.md

File metadata and controls

164 lines (135 loc) · 5.01 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.IVdsSubSystem.SetStatus
IVdsSubSystem::SetStatus (vds.h)
The IVdsSubSystem::SetStatus method (vds.h) sets the status of the subsystem to the specified value.
IVdsSubSystem interface [VDS]
SetStatus method
IVdsSubSystem.SetStatus
IVdsSubSystem::SetStatus
SetStatus
SetStatus method [VDS]
SetStatus method [VDS]
IVdsSubSystem interface
base.ivdssubsystem_setstatus
vds/IVdsSubSystem::SetStatus
vdshwprv/IVdsSubSystem::SetStatus
base\ivdssubsystem_setstatus.htm
base
07104aac-acdc-447c-9a30-ff3318f6df09
08/08/2022
IVdsSubSystem interface [VDS],SetStatus method, IVdsSubSystem.SetStatus, IVdsSubSystem::SetStatus, SetStatus, SetStatus method [VDS], SetStatus method [VDS],IVdsSubSystem interface, base.ivdssubsystem_setstatus, vds/IVdsSubSystem::SetStatus, vdshwprv/IVdsSubSystem::SetStatus
vds.h
Windows
Windows Vista [desktop apps only]
Windows Server 2003 [desktop apps only]
Uuid.lib
Windows
19H1
IVdsSubSystem::SetStatus
vds/IVdsSubSystem::SetStatus
c++
APIRef
kbSyntax
COM
Uuid.lib
Uuid.dll
IVdsSubSystem.SetStatus

IVdsSubSystem::SetStatus

-description

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

Sets the status of the subsystem to the specified value.

-parameters

-param status [in]

Values enumerated by VDS_SUB_SYSTEM_STATUS. Callers can pass in a subset of the possible enumeration values. Passing in VDS_SSS_UNKNOWN returns E_INVALIDARG.

-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

Implementers are responsible for performing any necessary operations to get the status to the specified state. For example, if the caller passes in VDS_SSS_OFFLINE as the subsystem status, the cache might first need to be cleared.

-see-also

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsSubSystem

VDS_SUB_SYSTEM_STATUS