ISCSI_DiscoveredTargetPortal2 structure (iscsifnd.h)
The ISCSI_DiscoveredTargetPortal2 structure provides information that is associated with a discovered target portal.
Syntax
typedef struct _ISCSI_DiscoveredTargetPortal2 {
USHORT Socket;
ISCSI_IP_Address Address;
ULONG SecurityBitmap;
ULONG KeySize;
UCHAR Key[1];
} ISCSI_DiscoveredTargetPortal2, *PISCSI_DiscoveredTargetPortal2;
Members
Socket
The socket number of the portal.
Address
The network address of the portal.
SecurityBitmap
A bitmap, which is defined in the iSNS specification, that indicates the security characteristics of logon connections that are made to this target portal. The following table describes possible security flag values.
| Security flags | Meaning |
|---|---|
| ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED | The initiator HBA should log on targets by using IPsec tunnel mode. If this bit is not set IPsec tunnel mode is not required. |
| ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED | The initiator HBA should log on targets by using IPsec transport mode. If this bit is not set IPsec transport mode is not required. |
| ISCSI_SECURITY_FLAG_PFS_ENABLED | The initiator HBA should log on targets with Perfect Forward Secrecy (PFS) mode enabled; otherwise, the initiator HBA should make the session connection with PFS mode disabled. |
| ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED | The initiator HBA should log on targets with aggressive mode enabled. If this bit is not set the initiator HBA should make the session connection with aggressive mode disabled. |
| ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED | The initiator HBA should log on targets with main mode enabled. If this bit is not set the initiator HBA should make the session connection with main mode disabled. |
| ISCSI_SECURITY_FLAG_IKE_IPSEC_ENABLED | The initiator HBA should log on targets with the IKE/IPsec protocol enabled. If this bit is not set the IKE/IPsec protocol is disabled. |
| ISCSI_SECURITY_FLAG_VALID | The other mask values are valid. If this bit is not set security flags are not specified.. |
For more information about how to configure the default security characteristics that are assigned of the target portal in the registry, see the Remarks section.
KeySize
The size, in bytes, of the encryption key in the Key member.
Key[1]
A variable-length array of characters that contains the encryption key that is associated with the portal address.
Remarks
The ISCSI_DiscoveredTargetPortal2 structure is a superset of the information that is provided by the ISCSI_DiscoveredTargetPortal structure, which only defines the target portal address. In addition to the network address of the target portal, the ISCSI_DiscoveredTargetPortal2 structure contains information about the target portal's security characteristics.
If the iSNS server does not assign a security bitmap to the target portal, the operating system associates the bitmap in the DefaultSecurityBitmap registry value with the portal. The DefaultSecurityBitmap registry value is located under the following registry key: HKLM\Software\Microsoft\Windows NT\Current Version\ISCSI\Discovery Values.
The default security bitmap is useful in cases where the target portal is configured for IPsec but does not support iSNS.
In general, management applications should use the iSCSI client PSKey command to configure the security bitmap for a target portal. But if there are a large number of portals that have the same security bitmap, the default security bitmap is a good way to automatically assign the same bitmap to all portals.
The WMI tool suite automatically generates a declaration of the ISCSI_DiscoveredTargetPortal2 structure when it compiles the ISCSI_DiscoveredTargetPortal WMI Class in Discover.mof.
Requirements
| Requirement | Value |
|---|---|
| Header | iscsifnd.h (include Iscsifnd.h) |