Fibre Channel SNIA HBA API Programmer's Guide

HBA_SetRNIDMgmtInfo
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_SetRNIDMgmtInfo(
HBA_HANDLE handle,
HBA_MGMTINFO *p_info
);
Purpose: Sets the RNID returned from the HBA.
Input Parameters: handle - Handle to an adapter already opened by a call to
HBA_OpenAdapter().
p_info - Pointer to structure containing management information.
Output Parameters: None.
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_SetRNIDMgmtInfo(adapter_handle,
&info)) == HBA_STATUS_OK)
{
printf("Success in HBA_SetRNIDMgmtInfo\n");
} else
{
printf("Error in HBA_SetRNIDMgmtInfo\n");
}
24 HBA Common Library APIs