Skip to content

Latest commit

 

History

History
165 lines (133 loc) · 5.3 KB

nf-vdshwprv-ivdslunmpio-setloadbalancepolicy.md

File metadata and controls

165 lines (133 loc) · 5.3 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.IVdsLunMpio.SetLoadBalancePolicy
IVdsLunMpio::SetLoadBalancePolicy (vdshwprv.h)
The IVdsLunMpio::SetLoadBalancePolicy (vdshwprv.h) method sets the load balance policy on the LUN.
IVdsLunMpio interface [VDS]
SetLoadBalancePolicy method
IVdsLunMpio.SetLoadBalancePolicy
IVdsLunMpio::SetLoadBalancePolicy
SetLoadBalancePolicy
SetLoadBalancePolicy method [VDS]
SetLoadBalancePolicy method [VDS]
IVdsLunMpio interface
base.ivdslunmpio_setloadbalancepolicy
vds/IVdsLunMpio::SetLoadBalancePolicy
vdshwprv/IVdsLunMpio::SetLoadBalancePolicy
base\ivdslunmpio_setloadbalancepolicy.htm
base
2f3eb00a-864e-4fb7-a722-4537e6b8dd42
08/08/2022
IVdsLunMpio interface [VDS],SetLoadBalancePolicy method, IVdsLunMpio.SetLoadBalancePolicy, IVdsLunMpio::SetLoadBalancePolicy, SetLoadBalancePolicy, SetLoadBalancePolicy method [VDS], SetLoadBalancePolicy method [VDS],IVdsLunMpio interface, base.ivdslunmpio_setloadbalancepolicy, vds/IVdsLunMpio::SetLoadBalancePolicy, vdshwprv/IVdsLunMpio::SetLoadBalancePolicy
vdshwprv.h
Windows
Windows Vista [desktop apps only]
Windows Server 2003 R2 [desktop apps only]
Windows
19H1
IVdsLunMpio::SetLoadBalancePolicy
vdshwprv/IVdsLunMpio::SetLoadBalancePolicy
c++
APIRef
kbSyntax
COM
Vds.h
VdsHwPrv.h
IVdsLunMpio.SetLoadBalancePolicy

IVdsLunMpio::SetLoadBalancePolicy

-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 load balance policy on the LUN.

-parameters

-param policy

The load balance policy enumerated by the
VDS_LOADBALANCE_POLICY_ENUM enumeration.

-param pPaths

A pointer to an array of members of the VDS_PATH_POLICY structure that contain the path-specific policy information.

-param lNumberOfPaths

The number of members of the VDS_PATH_POLICY structure in the array pointed to by the pPaths parameter.

-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
S_OK
The load balance policy was successfully set.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
The cache of the provider is corrupted. This indicates a software or communication problem inside a provider that caches information about the attached devices. The caller can use the IVdsHwProvider::Reenumerate method followed by the IVdsHwProvider::Refresh method to restore the cache.
VDS_E_OBJECT_DELETED
0x8004240BL
The LUN object is no longer present.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
The LUN 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 previous operations are complete.

-see-also

IVdsLunMpio

IVdsLunMpio::GetLoadBalancePolicy

VDS_LOADBALANCE_POLICY_ENUM

VDS_PATH_POLICY