3.4.5.2.13.2 IVdsIscsiInitiatorPortal::GetInitiatorAdapter (Opnum 4)

  • Article

The GetInitiatorAdapter method returns the initiator adapter to the initiator portal it belongs to.

 HRESULT GetInitiatorAdapter(
   [out] IVdsIscsiInitiatorAdapter** ppInitiatorAdapter
 );

ppInitiatorAdapter: A pointer to an IVdsIscsiInitiatorAdapter interface that, if the operation is successfully completed, receives the IVdsIscsiInitiatorAdapter interface of the initiator adapter object that the initiator portal belongs to. Callers MUST release the interface when 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 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 following parameter:

  • Verify that ppInitiatorAdapter is not NULL.

The server MUST point ppInitiatorAdapter to an IVdsIscsiInitiatorAdapter interface of the initiator adapter object that the initiator portal object's initiator adapter pointer refers to. The server MUST then return an HRESULT indicating failure or success.