Skip to content

Latest commit

 

History

History
165 lines (127 loc) · 5.05 KB

nf-vdshwprv-ivdsdrive-clearflags.md

File metadata and controls

165 lines (127 loc) · 5.05 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:vdshwprv.IVdsDrive.ClearFlags
IVdsDrive::ClearFlags (vdshwprv.h)
The IVdsDrive::ClearFlags (vdshwprv.h) method clears the flags of a drive object.
ClearFlags
ClearFlags method [VDS]
ClearFlags method [VDS]
IVdsDrive interface
IVdsDrive interface [VDS]
ClearFlags method
IVdsDrive.ClearFlags
IVdsDrive::ClearFlags
base.ivdsdrive_clearflags
vds/IVdsDrive::ClearFlags
vdshwprv/IVdsDrive::ClearFlags
base\ivdsdrive_clearflags.htm
base
195f0c13-40d7-4fad-b589-063ec4ff4efe
08/08/2022
ClearFlags, ClearFlags method [VDS], ClearFlags method [VDS],IVdsDrive interface, IVdsDrive interface [VDS],ClearFlags method, IVdsDrive.ClearFlags, IVdsDrive::ClearFlags, base.ivdsdrive_clearflags, vds/IVdsDrive::ClearFlags, vdshwprv/IVdsDrive::ClearFlags
vdshwprv.h
Windows
Windows Vista [desktop apps only]
Windows Server 2003 [desktop apps only]
Uuid.lib
Windows
19H1
IVdsDrive::ClearFlags
vdshwprv/IVdsDrive::ClearFlags
c++
APIRef
kbSyntax
COM
Uuid.lib
Uuid.dll
IVdsDrive.ClearFlags

IVdsDrive::ClearFlags

-description

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

Clears the flags of a drive object.

-parameters

-param ulFlags [in]

The flags enumerated by VDS_DRIVE_FLAG. Callers can clear the VDS_DRF_HOTSPARE flag.

-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 controller object is no longer present.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
The drive 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

Use IVdsDrive::SetFlags to set drive flags and IVdsDrive::GetProperties to get currently set flags.

-see-also

IVdsDrive

IVdsDrive::GetProperties

IVdsDrive::SetFlags

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

VDS_DRIVE_FLAG

VDS_DRIVE_PROP