HBA_GetBindingCapability routine
The HBA_GetBindingCapability routine retrieves the binding capabilities of the indicated port.
Syntax
HBA_STATUS HBA_API HBA_GetBindingCapability(
_In_ HBA_HANDLE Handle,
_In_ HBA_WWN HbaPortWWN,
_Out_ HBA_BIND_CAPABILITY *Flags
);
Parameters
Handle [in]
Contains a value returned by the routine HBA_OpenAdapter that identifies the HBA on which the port is located.HbaPortWWN [in]
Contains a 64-bit worldwide name (WWN) that uniquely identifies the local HBA port whose persistent binding capabilities will be retrieved. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.Flags [out]
Contains a bitwise OR of flags associated with the HBA_BIND_TYPE WMI property qualifier that represent the persistent binding capabilities of the port.
Return value
The HBA_GetBindingCapability routine returns a value of type HBA_STATUS that indicates the status of the HBA. In particular, HBA_GetBindingCapability returns one of the following qualifiers.
Return code | Description |
---|---|
HBA_STATUS_ERROR_ILLEGAL_WWN | Returned if the adapter does not contain a port with the name HbaPortWWN. |
HBA_STATUS_ERROR_NOT_SUPPORTED | Returned if the adapter does not support persistent bindings. |
HBA_STATUS_ERROR | Returned if an unspecified error occurred that prevented the retrieval of the port attributes. |
Requirements
Target platform |
Desktop |
Header |
Hbaapi.h (include Hbaapi.h) |
Library |
Hbaapi.lib |
DLL |
Hbaapi.dll |
See also