HBA_FCPBindingEntry2 structure

Article
10/05/2017

The HBA_FCPBindingEntry2 structure defines a binding between the information that uniquely identifies a logical unit for the operating system and the fibre channel protocol (FCP) identifier for the logical unit.

Syntax

typedef struct HBA_FCPBindingEntry2 {
  HBA_BIND_TYPE type;
  HBA_SCSIID    ScsiId;
  HBA_FCPID     FcpId;
  HBA_LUID      LUID;
  HBA_STATUS    Status;
} HBA_FCPBINDINGENTRY2, *PHBA_FCPBINDINGENTRY2;

Members

type
Contains a binding type that indicates how the target is specified in the binding. This member can have any of the following values:

Type Value	Meaning
HBA_BIND_TO_D_ID	Indicates that the target is identified by its fibre channel protocol (FCP) ID. The Fcid member of the HBA_FcpId structure contains this value.
HBA_BIND_TO_WWPN	Indicates that the target is identified by its worldwide port name. The PortWWN member of the HBA_FcpId structure contains this value.
HBA_BIND_TO_WWNN	Indicates that the fibre channel target device is identified by its worldwide node name. The NodeWWN member of the HBA_FcpId structure contains this value.
HBA_BIND_TO_LUID	Indicates that the target is identified by its fibre channel logical unit ID. The FcpLun member of the HBA_FcpId structure contains this value.
HBA_BIND_TARGETS	Indicates that the system should automatically generate target mappings from logical unit numbers to fibre channel protocol identifiers.

For a comparable set of values that define how an HBA specifies targets and logical units in the persistent bindings that it maintains, see the WMI property qualifier HBA_BIND_TYPE.

For a more detailed description of the values that this member can have, see the T11 committee's Fibre Channel HBA API specification.

ScsiId
Contains a structure of type HBA_ScsiId that contains the information that uniquely identifies a logical unit for the operating system.
FcpId
Contains a structure of type HBA_FcpId that contains the FCP identifier for the logical unit and information about the port to be queried for information about the device.
LUID
Contains a structure of type HBA_LUID that holds a logical unit descriptor for the device that the operating system derives from SCSI inquiry data.
Status
Contains, on return, a status value that indicates the condition of the HBA. The status values that can be returned in this member correspond to the values associated with the HBA_STATUS WMI property qualifier.

HBA_fcpbindingtype

typedef enum HBA_fcpbindingtype { TO_D_ID, TO_WWN, TO_OTHER } HBA_FCPBINDINGTYPE;

Remarks

This structure is very similar to the HBAFCPBindingEntry2 structure. The only difference is that HBA_FCPBindingEntry2 returns HBA status.

Requirements

Header

Hbaapi.h (include Hbaapi.h)

Share via