[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

3.4.5.2.7 IVdsServiceHba Methods3.4.5.2.7.1 IVdsServiceHba::QueryHbaPorts (Opnum 3)The QueryHbaPorts method returns an IEnumVdsObject enumeration object that contains a listof the HBA ports that are known to VDS on the system.HRESULT QueryHbaPorts([out] IEnumVdsObject** ppEnum);ppEnum: A pointer to an IEnumVdsObject interface that, if the operation is successfullycompleted, receives the IEnumVdsObject interface of the object that contains anenumeration of the HBA port objects on the server. Callers MUST release the interface whenthey are done with it.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.When the server receives this message, it MUST validate the following parameter:•Verify that ppEnum is not NULL.The server MUST point ppEnum to an IEnumVdsObject interface that contains the enumeration ofthe HBA port objects in the list of cached storage management objects, as specified in section3.4.1.3, and return an HRESULT indicating failure or success.3.4.5.2.8 IVdsServiceIscsi Methods3.4.5.2.8.1 IVdsServiceIscsi::GetInitiatorName (Opnum 3)The GetInitiatorName method returns the iSCSI name of the initiator service.HRESULT GetInitiatorName([out, string] WCHAR** ppwszIscsiName);ppwszIscsiName: A pointer that, if the operation is successfully completed, receives a nullterminatedUnicode string with the iSCSI name.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.When the server receives this message, it MUST validate the following parameter:•Verify that ppwszIscsiName is not NULL.The server MUST set ppwszIscsiName to point to a string that contains the iSCSI name of the iSCSIinitiator on the system and return an HRESULT indicating failure or success.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011183 / 360