SetIScsiTunnelModeOuterAddressA function (iscsidsc.h)

SetIscsiTunnelModeOuterAddress function establishes the tunnel-mode outer address that the indicated initiator Host Bus Adapter (HBA) uses when communicating in IPsec tunnel mode through the specified port.

Syntax

ISDSC_STATUS ISDSC_API SetIScsiTunnelModeOuterAddressA(
  [in, optional] PSTR    InitiatorName,
  [in]           ULONG   InitiatorPortNumber,
  [in]           PSTR    DestinationAddress,
  [in]           PSTR    OuterModeAddress,
  [in]           BOOLEAN Persist
);

Parameters

[in, optional] InitiatorName

The name of the initiator with which the tunnel-mode outer address will be associated. If this parameter is null, all HBA initiators are configured to use the indicated tunnel-mode outer address.

[in] InitiatorPortNumber

Indicates the number of the port with which the tunnel-mode outer address is associated. If this parameter contains ISCSI_ALL_PORTS, all ports on the indicated initiator are associated with the tunnel-mode outer address.

[in] DestinationAddress

The destination address to associate with the tunnel-mode outer address indicated by OuterModeAddress.

[in] OuterModeAddress

The tunnel-mode outer address to associate with indicated initiators and ports.

[in] Persist

When true, this parameter indicates that the iSCSI initiator service stores the tunnel-mode outer address in non-volatile memory and that the address will persist across restarts of the initiator and the iSCSI initiator service.

Return value

Returns ERROR_SUCCESS if the operation succeeds.Otherwise, it returns the appropriate Win32 or iSCSI error code.

Remarks

Requirements