Edit

ISCSI_DEVICE_ON_SESSIONA structure (iscsidsc.h)

  • Article

The ISCSI_DEVICE_ON_SESSION structure specifies multiple methods for identifying a device associated with an iSCSI login session.

Syntax

typedef struct {
  CHAR                  InitiatorName[MAX_ISCSI_HBANAME_LEN];
  CHAR                  TargetName[MAX_ISCSI_NAME_LEN + 1];
  SCSI_ADDRESS          ScsiAddress;
  GUID                  DeviceInterfaceType;
  CHAR                  DeviceInterfaceName[MAX_PATH];
  CHAR                  LegacyName[MAX_PATH];
  STORAGE_DEVICE_NUMBER StorageDeviceNumber;
  DWORD                 DeviceInstance;
} ISCSI_DEVICE_ON_SESSIONA, *PISCSI_DEVICE_ON_SESSIONA;

Members

InitiatorName[MAX_ISCSI_HBANAME_LEN]

A string that indicates the initiator name.

TargetName[MAX_ISCSI_NAME_LEN + 1]

A string that indicates the target name.

ScsiAddress

A SCSI_ADDRESS structure that contains the SCSI address of the device.

DeviceInterfaceType

A GUID that specifies the device interface class associated with the device. Device interface class GUIDs include, but are not limited to, the following:

GUID Type of Device
GUID_DEVINTERFACE_DISK Disk
GUID_DEVINTERFACE_TAPE Tape
GUID_DEVINTERFACE_CDROM CD-ROM
GUID_DEVINTERFACE_WRITEONCEDISK Write Once Disk
GUID_DEVINTERFACE_CDCHANGER CD Changer
GUID_DEVINTERFACE_MEDIUMCHANGER Medium Changer
GUID_DEVINTERFACE_FLOPPY Floppy

DeviceInterfaceName[MAX_PATH]

A string that specifies the name of the device interface class.

LegacyName[MAX_PATH]

A string that specifies the legacy device name.

StorageDeviceNumber

A STORAGE_DEVICE_NUMBER structure containing the storage device number.

DeviceInstance

A handle to the instance of the device in the devnode tree. For information on the cfgmgr32Xxx functions that utilize this handle, see PnP Configuration Manager Functions.

Remarks

Note

The iscsidsc.h header defines ISCSI_DEVICE_ON_SESSION 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]
Header iscsidsc.h

See also

SCSI_ADDRESS

STORAGE_DEVICE_NUMBER