The HBA_OpenAdapterByWWN routine opens the HBA that is associated with either a node or a port that has the indicated name.
HBA_STATUS HBA_API HBA_OpenAdapterByWWN( _Out_ HBA_HANDLE *HbaHandle, _In_ HBA_WWN Wwn );
Contains, on output, a handle that identifies the HBA.
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.
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.
Returned if HBA_OpenAdapterByWWN successfully returns a valid handle.
Returned if there is no HBA that has a port name or node name that matches 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.
Returned if an unspecified error occurred that prevented the opening of the adapter.
|Hbaapi.h (include Hbaapi.h)|