SM_GetPersistentBinding function
The SM_GetPersistentBinding method retrieves the bindings that an HBA miniport driver uses. These bindings map the OS-specific LUN information to the fibre channel protocol (FCP) identifiers for the logical units.
Syntax
void SM_GetPersistentBinding(
[in, HBAType("HBA_WWN")] uint8 HbaPortWWN[8],
[in, HBAType("HBA_WWN")] uint8 DomainPortWWN[8],
[in] uint32 InEntryCount,
[out, HBA_STATUS_QUALIFIERS] HBA_STATUS HBAStatus,
[out] uint32 TotalEntryCount,
[out] uint32 OutEntryCount,
[out, WmiSizeIs("OutEntryCount")] MS_SMHBA_BINDINGENTRY Bindings[]
);
Parameters
HbaPortWWN
A worldwide name (WWN) for the port whose persistent bindings will be retrieved.
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 was 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.
HBAStatus
The status of the operation. For a list of allowed values and their descriptions, see the HBA_STATUS structure. The miniport driver returns this information in the HBAStatus member of a GetPersistentBinding_OUT structure.
TotalEntryCount
The total number of persistent bindings that are associated with the HBA.
OutEntryCount
The total number of persistent bindings that are retrieved by the SM_GetPersistentBinding method. This value will be less than or equal to TotalEntryCount.
Bindings
An array of structures of type MS_SMHBA_BINDINGENTRY that describe an HBA's bindings between the operating system and the fibre channel protocol (FCP) identifiers.
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 |