Opens the specified adapter for reading.
Common Host Bus Adapter Library (libHBAAPI.a)
#include <sys/hbaapi.h>
HBA_HANDLE HBA_OpenAdapter (adaptername)
char *adaptername;The HBA_OpenAdapter subroutine opens the adapter for reading for the purpose of getting it ready for additional calls from other subroutines in the Common HBA API.
The HBA_OpenAdapter subroutine allows an application to open a specified HBA device, giving the application access to the device through the HBA_HANDLE return value. The library ensures that all access to this HBA_HANDLE between HBA_OpenAdapter and HBA_CloseAdapter calls is to the same device.
| Item | Description |
|---|---|
| adaptername | Specifies a string that contains the description of the adapter as returned by the HBA_GetAdapterName subroutine. |
If successful, the HBA_OpenAdapter subroutine returns an HBA_HANDLE with a value greater than 0. If unsuccessful, the subroutine returns a 0.