HBA_OpenAdapterByWWN routine
The HBA_OpenAdapterByWWN routine opens the HBA that is associated with either a node or a port that has the indicated name.
Syntax
HBA_STATUS HBA_API HBA_OpenAdapterByWWN(
_Out_ HBA_HANDLE *HbaHandle,
_In_ HBA_WWN Wwn
);
Parameters
HbaHandle [out]
Contains, on output, a handle that identifies the HBA.Wwn [in]
Contains a 64-bit worldwide name (WWN) that must either match the name of the node on which the HBA is located, or must match the name of a port on the HBA. For a discussion of worldwide names, see the T11 committee's Fibre Channel HBA API specification.
Return value
The HBA_OpenAdapterByWWN routine returns a value of type HBA_STATUS that indicates the status of the HBA. In particular, HBA_OpenAdapterByWWN returns one of the following qualifiers.
| Return code | Description |
|---|---|
| HBA_STATUS_OK | Returned if HBA_OpenAdapterByWWN successfully returns a valid handle. |
| HBA_STATUS_ERROR_ILLEGAL_WWN | Returned if there is no HBA that has a port name or node name that matches Wwn. |
| HBA_STATUS_ERROR_AMBIGUOUS_WWN | Returned if multiple adapters have associated port or node names that match Wwn. This can occur if two or more adapters are associated with nodes of the same name. |
| HBA_STATUS_ERROR | Returned if an unspecified error occurred that prevented the opening of the adapter. |
Requirements
Target platform |
Desktop |
Header |
Hbaapi.h (include Hbaapi.h) |
Library |
Hbaapi.lib |
DLL |
Hbaapi.dll |
See also