HBA_SetBindingSupport routine
The HBA_SetBindingSupport routine enables the indicated set of capabilities on the adapter.
Syntax
HBA_STATUS HBA_API HBA_SetBindingSupport(
_In_ HBA_HANDLE Handle,
_In_ HBA_WWN HbaPortWWN,
_In_ HBA_BIND_CAPABILITY Flags
);
Parameters
Handle [in]
Contains a value returned by the routine HBA_OpenAdapter that identifies the HBA on which the port referenced by HbaPortWWN is located.HbaPortWWN [in]
Contains a 64-bit worldwide name (WWN) that uniquely identifies the port for which the binding capabilities specified by Flags are enabled. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.Flags [in]
Contains a bitwise OR of a set of flags that indicate the capabilities to enable on the port referenced by HbaPortWWN. For a description of the flags, see the corresponding values associated with the HBA_BIND_TYPE WMI property qualifier.
Return value
The HBA_SetBindingSupport routine returns a value of type HBA_STATUS that indicates the status of the HBA. In particular, HBA_SetBindingSupport returns one of the following values.
| Return code | Description |
|---|---|
| HBA_STATUS_OK | Returned if the binding capabilities were successfully enabled. |
| HBA_STATUS_ERROR_ILLEGAL_WWN | Returned if the HBA referenced by handle does not contain a port with a name that matches HbaPortWWN. |
| HBA_STATUS_ERROR_NOT_SUPPORTED | Returned if the adapter referenced by handle does not support persistent bindings. |
| HBA_STATUS_ERROR_INCAPABLE | Returned if one or more of the flags specified by Flags corresponds to a capability not implemented for the port referenced by HbaPortWWN. |
| HBA_STATUS_ERROR | Returned if an unspecified error occurred that prevented the routine from enabling the specified capabilities. |
Requirements
Target platform |
Desktop |
Header |
Hbaapi.h (include Hbaapi.h) |
Library |
Hbaapi.lib |
DLL |
Hbaapi.dll |
See also