3.4.5.2.12.2 IVdsIscsiInitiatorAdapter::QueryInitiatorPortals (Opnum 4)

  • Article

The QueryInitiatorPortals method returns an object that enumerates the iSCSI initiator portals of the initiator adapter.

 HRESULT QueryInitiatorPortals(
   [out] IEnumVdsObject** ppEnum
 );

ppEnum: A pointer to an IEnumVdsObject interface that, if the operation is successfully completed, receives the IEnumVdsObject interface of the object containing an enumeration of initiator portal objects in the initiator adapter. Callers MUST release the interface when they are done with it.

Return Values: The method MUST return zero or a nonerror HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code to indicate failure. For the HRESULT values predefined by the Virtual Disk Service Remote Protocol, see section 2.2.3.

When the server receives this message, it MUST validate the parameters:

  • Verify that ppEnum is not NULL.

The server MUST point ppEnum to an IEnumVdsObject interface that contains the enumeration of iSCSI initiator portal objects in the list of cached storage management objects that have their initiator adapter pointer set to this initiator adapter object. The server MUST then return an HRESULT indicating failure or success.