HBA_SendRNID routine
The HBA_SendRNID 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_SendRNID(
_In_ HBA_HANDLE HbaHandle,
_In_ HBA_WWN Wwn,
_In_ HBA_WWNTYPE WwnType,
_Out_ void *pRspBuffer,
_Inout_ HBA_UINT32 *RspBufferSize
);
Parameters
HbaHandle [in]
Contains a value returned by the routine HBA_OpenAdapter that identifies the HBA that will route the command. The HBA routes this command to the appropriate fabric configuration server.Wwn [in]
Contains a 64-bit worldwide name (WWN) that uniquely identifies a port or a node from which the RNID command is issued. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.WwnType [in]
Contains an enumerator value of type HBA_wwntype that indicates whether the WWN specified by Wwn is a port or a node:pRspBuffer [out]
Pointer to a buffer that contains, in big-endian (wire) format, the payload data 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_SendRNID 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_SendRNID 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