SM_SetPersistentBinding function

Article
12/15/2021

The SM_SetPersistentBinding method sets the bindings that are used by the HBA miniport driver to map the OS-specific LUN information to the fibre channel protocol (FCP) identifiers for the logical units.

Syntax

void SM_SetPersistentBinding(
   [in, HBAType("HBA_WWN")] uint8                        HbaPortWWN[8],
   [in, HBAType("HBA_WWN")] uint8                        DomainPortWWN[8],
   [in] uint32                                           InEntryCount,
   [in, WmiSizeIs("InEntryCount")] MS_SMHBA_BINDINGENTRY Entry[],
   [out, HBA_STATUS_QUALIFIERS] HBA_STATUS               HBAStatus,
   [out] uint32                                          OutStatusCount,
   [out, HBA_STATUS_QUALIFIERS] HBA_STATUS               EntryStatus
);

Parameters

HbaPortWWN
A worldwide name (WWN) for the port whose persistent bindings will be set.

DomainPortWWN
The worldwide name (WWN) for the callback. It is the Port_Identifier that has the smallest value of any Port_Identifier of an SMP port that is discovered by using the physical fibre channel port. It has a value of zero if no SMP port has been discovered by using the physical fibre channel port.

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

Entry
An array of structures of type SMHBA_SCSIENTRY that describes an HBA's bindings between the operating system and the SAS identifiers.

HBAStatus
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 GetPersistentBinding_OUT structure.

OutStatusCount
The total number of persistent bindings that are retrieved by the SM_GetPersistentBinding method. This value will be less than or equal to TotalEntryCount.

EntryStatus
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 GetPersistentBinding_OUT structure.

Return value

Not applicable to WMI methods.

Remarks

This WMI method belongs to the MS_SM_TargetInformationMethods WMI Class.

Requirements

Target platform	Desktop
Header	Hbapiwmi.h