Share via


HBA_SendRNIDV2 routine

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

See also

HBA_OpenAdapter

HBA_SendRNID

SendRNID

 

 

Send comments about this topic to Microsoft