GetFcpPersistentBinding function

Article
12/15/2021

The GetFcpPersistentBinding method retrieves the bindings that an HBA miniport driver uses to map the information that an operating system uses to identify its logical units to the Fibre Channel protocol (FCP) identifiers for the logical units.

Syntax

void GetFcpPersistentBinding(
   [in] uint32                                          InEntryCount,
   [out, HBA_STATUS_QUALIFIERS] HBA_STATUS              HBAStatus,
   [out] uint32                                         TotalEntryCount,
   [out] uint32                                         OutEntryCount,
   [out, WmiSizeIs("OutEntryCount")] HBAFCPBindingEntry Entry[]
);

Parameters

InEntryCount
Indicates the number of binding entries that the WMI provider can report in the Entry parameter.

HBAStatus
On return, contains the status of the operation. For a list of allowed values and their descriptions, see HBA_STATUS. The miniport driver returns this information in the HBAStatus member of a GetFcpPersistentBinding_OUT structure.

TotalEntryCount
Indicates the total number of persistent bindings associated with the HBA.

OutEntryCount
Indicates the total number of persistent bindings retrieved by the GetFcpPersistentBinding method. This value will be less than or equal to TotalEntryCount.

Entry[]
An array of structures of type HBAFCPBindingEntry that describe an HBA's bindings between operating system and Fibre Channel protocol (FCP) identifiers.

Return value

Not applicable to WMI methods.

Remarks

This WMI method belongs to the MSFC_HBAFCPInfo WMI Class.

Requirements

Target platform	Desktop
Header	Hbapiwmi.h (include Hbapiwmi.h, Hbaapi.h, or Hbaapi.h)
Library	Hbaapi.lib