GetPersistentBinding2 function

Article
12/15/2021

The GetPersistentBinding2 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 GetPersistentBinding2(
   [in, HBAType("HBA_WWN")] uint8                        PortWWN[8],
   [in] uint32                                           InEntryCount,
   [out, HBA_STATUS_QUALIFIERS] HBA_STATUS               HBAStatus,
   [out] uint32                                          TotalEntryCount,
   [out] uint32                                          OutEntryCount,
   [out, WmiSizeIs("OutEntryCount")] HBAFCPBindingEntry2 Bindings[]
);

Parameters

PortWWN[8]
A worldwide name that indicates the port whose persistent bindings will be retrieved.

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 GetPersistentBinding2 method.. This value will be less than or equal to TotalEntryCount.

Bindings[]
An array of structures of type HBAFCPBindingEntry2 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)