IVdsLunIscsi::AssociateTargets method (vds.h)
[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]
Associates LUNs with subsystem iSCSI targets.
Syntax
HRESULT AssociateTargets(
[in] VDS_OBJECT_ID *pTargetIdArray,
[in] LONG lNumberOfTargets
);
Parameters
[in] pTargetIdArray
A pointer to an array of target VDS_OBJECT_ID data types. The provider associates these iSCSI targets with the LUN. This array includes targets already associated with the LUN that are to remain so.
[in] lNumberOfTargets
The number of targets specified in the pTargetArray parameter.
Return value
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 |
---|---|
|
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. |
|
The LUN object is no longer present. |
|
The LUN is in a failed state, and is unable to perform the requested operation. |
|
Another operation is in progress; this operation cannot proceed until the previous operation or operations are complete. |
|
Can be returned from any method that takes a VDS_OBJECT_ID constant. This return value indicates that the identifier does not refer to an existing object. |
|
This operation or combination of parameters is not supported by this provider. |
Remarks
Most subsystems implement only one associated target per LUN, but some allow for multiple associated targets.
Use the IVdsLunIscsi::QueryAssociatedTargets method to query target associations. Use the IVdsIscsiTarget::QueryAssociatedLuns method to query the LUNs associated with a target.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2003 R2 [desktop apps only] |
Target Platform | Windows |
Header | vds.h |
Redistributable | VDS 1.1 |