MSiSCSI_BootConfiguration structure (iscsicfg.h)

The MSiSCSI_BootConfiguration structure describes how the boot device is configured.

Syntax

typedef struct _MSiSCSI_BootConfiguration {
  ULONGLONG          LUN;
  ULONGLONG          SecurityFlags;
  ULONG              UsernameSize;
  ULONG              PasswordSize;
  BOOLEAN            DiscoverBootDevice;
  WCHAR              InitiatorNode[223 + 1];
  WCHAR              TargetName[223 + 1];
  ISCSI_TargetPortal TargetPortal;
  ISCSI_LoginOptions LoginOptions;
  UCHAR              Username[1];
} MSiSCSI_BootConfiguration, *PMSiSCSI_BootConfiguration;

Members

LUN

The logical unit number (LUN) that identifies the logical unit on the target that functions as a boot device.

SecurityFlags

A bitwise OR of security flags that indicate the security requirements of the boot device. For a list of possible flags for this member, see SECURITY_FLAG_QUALIFIERS.

UsernameSize

The size, in bytes, of the string in Username.

PasswordSize

The size, in bytes, of the string in Password.

DiscoverBootDevice

A Boolean value that indicates whether the system should dynamically discover the boot device. If this member is TRUE, the system should dynamically discover the boot device.

InitiatorNode[223 + 1]

The iSCSI name of the initiator node to use for connecting to the boot device. If this member is NULL, the HBA can choose any initiator node. The iSCSI name for the initiator uniquely identifies the initiator anywhere in the world. For more information about how to specify this name, see the iSCSI specification that is published by the Internet Engineering Task Force (IETF) of the IP storage working group.

TargetName[223 + 1]

The iSCSI name for the target that contains the boot device.

TargetPortal

A ISCSI_TargetPortal structure that specifies the portal to use for the connection.

LoginOptions

A ISCSI_LoginOptions structure that specifies the characteristics of the logon session to establish with the boot device.

Username[1]

A variable length array of characters that specifies the user name to use with the challenge handshake authentication protocol (CHAP). The user name is also known as the CHAP name (CHAP_N). The initiator uses the CHAP name to authenticate the target.

Remarks

The WMI tool suite automatically generates a declaration of the MSiSCSI_BootConfiguration structure when it compiles the MSiSCSI_BootConfiguration WMI Class in Config.mof.It is optional that you implement this class.

Requirements

Requirement Value
Header iscsicfg.h (include Iscsicfg.h)

See also

ISCSI_LoginOptions

ISCSI_TargetPortal

MSiSCSI_BootConfiguration WMI Class

SECURITY_FLAG_QUALIFIERS