Fibre Channel SNIA HBA API Programmer's Guide

HBA_GetRNIDMgmtInfo
NOTE: HP's vendor library does not support this function. The application calling this API
will get HBA_STATUS_ERROR_NOT_SUPPORTED when all the arguments passed are valid.
Function:
HBA_STATUS HBA_GetRNIDMgmtInfo(
HBA_HANDLE handle,
HBA_MGMTINFO *p_info
);
Purpose: Returns the RNID from the HBA.
Input Parameters: handle - Handle to an adapter already opened by a call to
HBA_OpenAdapter().
Output Parameters: p_info - Pointer to buffer to receive management information in
big-endian format.
Return Values: Returned after a
successful execution of the
call.
HBA_STATUS_OK
HBA_STATUS_ERROR
Returned when an
internal library or system
error is detected.
HBA_STATUS_ERROR_BUSY
Returned when the library
is busy and cannot
currently process this call.
HBA_STATUS_ERROR_INVALID_HANDLE
Returned when the handle
passed to this function is
invalid.
HBA_STATUS_ERROR_ARG
Returned when any of the
pointers passed to this
function is NULL.
HBA_STATUS_ERROR_UNAVAILABLE
Returned when the
adapter to which the
handle corresponds is not
available.
HBA_STATUS_ERROR_NOT_SUPPORTED
Returned when all the
arguments passed are
valid and this function is
not supported by the
corresponding vendor
library.
Call order sequence: See Appendix A.
Example Code:
if ((status = HBA_GetRNIDMgmtInfo(adapter_handle,
&info)) == HBA_STATUS_OK)
{
printf("Error in HBA_GetRNIDMgmtInfo\n");
} else
{
printf("Error in HBA_GetRNIDMgmtInfo\n");
}
FC-3 Management Functions 25