Portal Object
[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]
A portal object models an iSCSI portal that is contained within an iSCSI subsystem.
Use the IVdsSubSystemIscsi::QueryPortals method to determine the iSCSI portals of the subsystem. Callers can get a pointer to a specific portal by selecting the desired portal object from the enumeration that is returned by the QueryPortals method. With a portal object, you can set the portal status and query for portal properties, associated portal groups, and the subsystem that contains the portal.
A portal object can only be associated with at most one portal group of a specified target.
Portals serve as one of the endpoints of MPIO paths in iSCSI hardware providers, upon which load balancing policies can be imposed.
Portal object properties include an object identifier, an IP address and port, and the portal status.
The following table lists related interfaces, enumerations, and structures.
| Type | Element |
|---|---|
| Interfaces that are always exposed by this object in VDS 1.1 and 2.0 iSCSI providers only | IVdsIscsiPortal. |
| Associated enumerations | VDS_ISCSI_PORTAL_STATUS. |
| Associated structures | VDS_ISCSI_PORTAL_PROP and VDS_PORT_NOTIFICATION. |
Related topics