Edit

SetIScsiTunnelModeOuterAddressW function (iscsidsc.h)

  • Article

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 SetIScsiTunnelModeOuterAddressW(
  [in, optional] PWSTR   InitiatorName,
  [in]           ULONG   InitiatorPortNumber,
  [in]           PWSTR   DestinationAddress,
  [in]           PWSTR   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

Note

The iscsidsc.h header defines SetIScsiTunnelModeOuterAddress as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header iscsidsc.h
Library Iscsidsc.lib
DLL Iscsidsc.dll