Skip to content

Latest commit

 

History

History
180 lines (144 loc) · 8.18 KB

nf-iscsidsc-addiscsisendtargetportalw.md

File metadata and controls

180 lines (144 loc) · 8.18 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:iscsidsc.AddIScsiSendTargetPortalW
AddIScsiSendTargetPortalW function (iscsidsc.h)
AddIscsiSendTargetPortal function adds a static target portal to the list of target portals to which the iSCSI initiator service transmits SendTargets requests. (Unicode)
AddIScsiSendTargetPortalW
AddIscsiSendTargetPortal
AddIscsiSendTargetPortal function [iSCSI Discovery Library API]
AddIscsiSendTargetPortalW
ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED
ISCSI_SECURITY_FLAG_IKE_IPSEC_ENABLED
ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED
ISCSI_SECURITY_FLAG_PFS_ENABLED
ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED
ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED
ISCSI_SECURITY_FLAG_VALID
iscsidisc.addiscsisendtargetportal
iscsidsc/AddIscsiSendTargetPortal
iscsidsc/AddIscsiSendTargetPortalW
iscsidisc\addiscsisendtargetportal.htm
iSCSIDisc
8ca378bd-400d-40f1-81d2-c8b4135a3d3c
12/05/2018
AddIScsiSendTargetPortalW, AddIscsiSendTargetPortal, AddIscsiSendTargetPortal function [iSCSI Discovery Library API], AddIscsiSendTargetPortalA, AddIscsiSendTargetPortalW, ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED, ISCSI_SECURITY_FLAG_IKE_IPSEC_ENABLED, ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED, ISCSI_SECURITY_FLAG_PFS_ENABLED, ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED, ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED, ISCSI_SECURITY_FLAG_VALID, iscsidisc.addiscsisendtargetportal, iscsidsc/AddIscsiSendTargetPortal, iscsidsc/AddIscsiSendTargetPortalA, iscsidsc/AddIscsiSendTargetPortalW
iscsidsc.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
AddIscsiSendTargetPortalW (Unicode) and AddIscsiSendTargetPortalA (ANSI)
Iscsidsc.lib
Iscsidsc.dll
Windows
19H1
AddIScsiSendTargetPortalW
iscsidsc/AddIScsiSendTargetPortalW
c++
APIRef
kbSyntax
DllExport
Iscsidsc.dll
AddIscsiSendTargetPortal
AddIscsiSendTargetPortalA
AddIscsiSendTargetPortalW

AddIScsiSendTargetPortalW function

-description

The AddIscsiSendTargetPortal function adds a static target portal to the list of target portals to which the iSCSI initiator service transmits SendTargets requests.

-parameters

-param InitiatorInstance [in, optional]

The initiator that the iSCSI initiator service utilizes to transmit SendTargets requests to the specified target portal. If null, the iSCSI initiator service will use any initiator that can reach the target portal.

-param InitiatorPortNumber [in, optional]

The port number to use for the SendTargets request. This port number corresponds to the source IP address on the Host-Bus Adapter (HBA). A value of ISCSI_ALL_INITIATOR_PORTS indicates that the initiator must select the appropriate port based upon current routing information.

-param LoginOptions [in, optional]

A pointer to a structure of type ISCSI_LOGIN_OPTIONS that contains the login options to use with the target portal.

-param SecurityFlags [in, optional]

A bitmap that specifies the characteristics of the IPsec connection that the initiator adds to the session. If IPsec security policy between the initiator and the target portal is already configured as a result of the portal group policy or a previous connection to the portal, the existing configuration takes precedence over the configuration specified in SecurityFlags and the security bitmap is ignored.

If the ISCSI_SECURITY_FLAG_VALID flag is set to 0, the iSCSI initiator service uses default values for the security flags that are defined in the registry.

Caller can set any of the following flags in the bitmap:

Value Meaning
ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED
When set to 1, the initiator should make the connection in IPsec tunnel mode. Caller should set this flag or the ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED flag, but not both.
ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED
When set to 1, the initiator should make the connection in IPsec transport mode. Caller should set this flag or the ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED flag, but not both.
ISCSI_SECURITY_FLAG_PFS_ENABLED
When set to 1, the initiator should make the connection with Perfect Forward Secrecy (PFS) mode enabled; otherwise, the initiator should make the connection with PFS mode disabled.
ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED
When set to 1, the initiator should make the connection with aggressive mode enabled. Caller should set this flag or the ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED flag, but not both.
Note  The Microsoft software initiator driver does not support aggressive mode.
 
ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED
When set to 1, the initiator should make the connection with main mode enabled. Caller should set this flag or the ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED flag, but not both.
ISCSI_SECURITY_FLAG_IKE_IPSEC_ENABLED
When set to 1, the initiator should make the connection with the IKE/IPsec protocol enabled; otherwise, the IKE/IPsec protocol is disabled.
ISCSI_SECURITY_FLAG_VALID
When set to 1, the other mask values are valid; otherwise, the iSCSI initiator service will use bitmap values that were previously defined for the target portal, or if none are available, the initiator service uses the default values defined in the registry.

-param Portal

A pointer to a structure of type ISCSI_TARGET_PORTAL that indicates the portal to which SendTargets will be sent for target discovery.

-returns

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

-see-also

ISCSI_LOGIN_OPTIONS

ISCSI_TARGET_PORTAL

-remarks

Note

The iscsidsc.h header defines AddIScsiSendTargetPortal 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.