HBA_GetAdapterName routine

The HBA_GetAdapterName routine retrieves the text string that identifies the HBA name that corresponds to the indicated adapter index.

Syntax

HBA_STATUS HBA_API HBA_GetAdapterName(
  _In_    HBA_UINT32 AdapterIndex,
  _Inout_ PCHAR      AdapterName
);

Parameters

  • AdapterIndex [in]
    Indicates the index of the HBA for which the name will be returned.

  • AdapterName [in, out]
    Pointer to memory area in which the HBA name will be returned. The HBA name will be a string of the form

    mfgdomain-model-adapterindex
    

    where mfgdomain is derived from the domain name owned by the manufacturer of the HBA, model is a vendor-specific identifier of the HBA product model, and adapterindex is a decimal representation of the HBA index in AdapterIndex. For example:

    com.HotBiscuitsAdapters-HBA1040A-1
    

    For a description of the formatting of the adapter name, see the Fibre Channel HBA API specification published by the T11 committee.

Return value

The HBA_GetAdapterName routine returns a value of type HBA_STATUS that indicates the status of the HBA.

Requirements

Target platform

Desktop

Header

Hbaapi.h (include Hbaapi.h)

Library

Hbaapi.lib

DLL

Hbaapi.dll

See also

HBA_AdapterAttributes

HBA_OpenAdapter

HBA_STATUS

 

 

Send comments about this topic to Microsoft