VDS_PATH_INFO structure (vds.h)

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

Defines the information for a LUN path. This structure is returned in the ppPaths parameter of the IVdsLunMpio::GetPathInfo method.

Syntax

typedef struct _VDS_PATH_INFO {
  VDS_PATH_ID         pathId;
  VDS_HWPROVIDER_TYPE type;
  VDS_PATH_STATUS     status;
  union {
    VDS_OBJECT_ID controllerPortId;
    VDS_OBJECT_ID targetPortalId;
  };
  union {
    VDS_OBJECT_ID hbaPortId;
    VDS_OBJECT_ID initiatorAdapterId;
  };
  union {
    VDS_HBAPORT_PROP *pHbaPortProp;
    VDS_IPADDRESS    *pInitiatorPortalIpAddr;
  };
} VDS_PATH_INFO;

Members

pathId

The unique ID of the path used by MPIO.

type

The type of interconnect that the hardware provider supports for this LUN path. VDS_HWT_HYBRID is not a valid value for this member, even if the provider is a hybrid provider.

status

The status of the path, enumerated by VDS_PATH_STATUS.

controllerPortId

The VDS_OBJECT_ID of the controller port object on the other end of the path.

targetPortalId

The VDS_OBJECT_ID of the target portal object on the other end of the path.

hbaPortId

The VDS_OBJECT_ID of the HBA port.

initiatorAdapterId

The VDS_OBJECT_ID of the initiator adapter.

pHbaPortProp

A pointer to a VDS_HBAPORT_PROP structure containing properties of the HBA port on one end of the path.

pInitiatorPortalIpAddr

A pointer to a VDS_IPADDRESS structure containing the IP address and port information for the initiator portal.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 R2 [desktop apps only]
Header	vds.h
Redistributable	VDS 1.1

See also

IVdsLunMpio::GetPathInfo

VDS_HBAPORT_PROP

VDS_HWPROVIDER_TYPE

VDS_IPADDRESS

VDS_PATH_ID

VDS_PATH_STATUS