SM_GetTargetMapping function

Article
12/15/2021

The SM_GetTargetMapping WMI method retrieves a mapping between the information that uniquely identifies a set of logical units for the operating system and the fibre channel protocol (FCP) identifiers for these logical units.

Syntax

void SM_GetTargetMapping(
   [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_SCSIENTRY Entry[]
);

Parameters

HbaPortWWN
A worldwide name (WWN) for the port whose table of mappings is to be retrieved. This information is delivered to the miniport driver in the HbaPortWWN member of a GetTargetMapping_IN structure.

DomainPortWWN
The worldwide name (WWN) for the callback. It is the Port_Identifier with 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.

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 GetFcpTargetMapping_OUT structure.

TotalEntryCount
The total number of persistent bindings that are associated with the HBA.

OutEntryCount
The total number of mappings that are retrieved by the SM_GetTargetMapping method. This value will be less than or equal to TotalEntryCount.

Entry
An array of structures of type MS_SMHBA_SCSIENTRY 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

Share via