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

3.4.5.2.8.2 IVdsServiceIscsi::QueryInitiatorAdapters (Opnum 4)The QueryInitiatorAdapters method returns an object that enumerates the iSCSI initiatoradapters of the initiator.HRESULT QueryInitiatorAdapters([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 initiator adapter objects on the server. Callers MUST release the interfacewhen they 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 ofiSCSI initiator adapter objects in the list of cached storage management objects, as specified insection 3.4.1.3, and return an HRESULT indicating failure or success.3.4.5.2.8.3 IVdsServiceIscsi::SetInitiatorSharedSecret (Opnum 8)The SetInitiatorSharedSecret method sets the initiator CHAP shared secret that is used formutual CHAP authentication when the initiator authenticates the target. For more information onCHAP, see [MS-CHAP].HRESULT SetInitiatorSharedSecret([in, unique] VDS_ISCSI_SHARED_SECRET* pInitiatorSharedSecret,[in] VDS_OBJECT_ID targetId);pInitiatorSharedSecret: A pointer to a VDS_ISCSI_SHARED_SECRET structure that containsthe CHAP shared secret that is used for mutual CHAP authentication when the initiatorauthenticates the target. For more information on CHAP, see [MS-CHAP].targetId: This parameter is reserved and not used by the protocol. Callers MUST pass inGUID_NULL. Callers MUST pass in GUID_NULL.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 parameters:•Verify that pInitiatorSharedSecret is not NULL.•Verify that targetId is GUID_NULL.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011184 / 360