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