HBA_SendRNIDV2 routine

Article
10/05/2017

The HBA_SendRNIDV2 routine sends a request for node identification data (RNID) to the indicated HBA, which in turn routes the request through the indicated port or node to the appropriate fabric configuration server.

Syntax

HBA_STATUS HBA_API HBA_SendRNIDV2(
  _In_    HBA_HANDLE handle,
  _In_    HBA_WWN    hbaPortWWN,
  _In_    HBA_WWN    destWWN,
  _In_    HBA_UINT32 destFCID,
  _In_    HBA_UINT32 NodeIdDataFormat,
  _Out_   void       *pRspBuffer,
  _Inout_ HBA_UINT32 *RspBufferSize
);

Parameters

handle [in]
Contains a value returned by the routine HBA_OpenAdapter that identifies the HBA that will route the command. The HBA routes this command through the port specified by hbaPortWWN to the port specified by destWWN on the appropriate fabric configuration server.
hbaPortWWN [in]
Contains a 64-bit worldwide name (WWN) that uniquely identifies a port from which the RNID command is issued. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.
destWWN [in]
Contains a WWN for the destination port on the fabric configuration server that will provide the node identification data.
destFCID [in]
Contains the fibre channel identifier of the destination port specified by destWWN. If no fibre channel identifier for the destination port is available, the caller should set this member to 0.
NodeIdDataFormat [in]
Contains a number that indicates the node identification format. For a complete description of the allowed formats and the numbers that identify each format, see the Fibre Channel Generic Services - 4 (FC-GS-4) specification published by the ANSI committee.
pRspBuffer [out]
Pointer to a buffer that contains the payload data, in big-endian (wire) format, from the reply to the node identification request.
RspBufferSize [in, out]
On input, indicates the size, in bytes, of the buffer pointed to by pRspBuffer. On return, this member indicates the size, in bytes, of the response data.

Return value

The HBA_SendRNIDV2 routine returns a value of type HBA_STATUS that indicates the status of the HBA.

Remarks

The node identification data request is a common transport (CT) command that queries a fabric configuration server for node identification data. For a complete description of this command, see the sections dealing with node identification requests in the Fibre Channel Generic Services - 4 (FC-GS-4) specification published by the ANSI committee.

The HBA_SendRNIDV2 library routine serves a purpose very similar to the SendRNID WMI method.

Requirements

Target platform	Desktop
Header	Hbaapi.h (include Hbaapi.h)
Library	Hbaapi.lib
DLL	Hbaapi.dll

Share via