SendRNIDV2 function

The SendRNIDV2 WMI method sends a version 2 RNID command to the indicated port.

Syntax

void SendRNIDV2(
   [out, HBA_STATUS_QUALIFIERS] HBA_STATUS       HBAStatus,
   [in, HBAType("HBA_WWN")] uint8                PortWWN[8],
   [in, HBAType("HBA_WWN")] uint8                DestWWN[8],
   [in] uint32                                   DestFCID,
   [in] uint32                                   NodeIdDataFormat,
   [out] uint32                                  TotalRspBufferSize,
   [out] uint32                                  ActualRspBufferSize,
   [out, WmiSizeIs("ActualRspBufferSize")] uint8 RspBuffer[]
);

Parameters

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

PortWWN
A worldwide name for the local port through which the version 2 RNID command is sent. This information is delivered to the miniport driver in the PortWWN member of a SendRNIDV2_IN structure.

DestWWN
A worldwide name for the destination port. This information is delivered to the miniport driver in the DestWWN member of a SendRNIDV2_IN structure.

DestFCID
An address identifier of the destination port. This information is delivered to the miniport driver in the DestFCID member of a SendRNIDV2_IN structure.

NodeIdDataFormat
The node identification data format. For a description of the values that this member can have, see the T11 committee's Fibre Channel HBA API specification. This information is delivered to the miniport driver in the NodeIdDataFormat member of a SendRNIDV2_IN structure.

TotalRspBufferSize
The size in bytes of the results of the version 2 RNID command. The miniport driver returns this information in the TotalRspBufferSize member of a SendRNIDV2_OUT structure.

ActualRspBufferSize
The size in bytes of the data that was actually retrieved. The miniport driver returns this information in the ActualRspBufferSize member of a SendRNIDV2_OUT structure.

RspBuffer
The results of the version 2 RNID command. The miniport driver returns this information in the RspBuffer member of a SendRNIDV2_OUT structure.

Return value

Not applicable to WMI methods.

Remarks

This WMI method belongs to the MSFC_HBAAdapterMethods WMI Class.

Requirements

Target platform

Desktop

Header

Hbapiwmi.h (include Hbapiwmi.h, Hbaapi.h, or Hbaapi.h)

Library

Hbaapi.lib

See also

HBA_STATUS

SendRNIDV2_IN

SendRNIDV2_OUT