NPAB_Get_HIN_From_HINName

Gets the Hardware Instance Number (HIN) associated with a HIN name.

Thread Context:Non-Blocking

Syntax

    LONG NPAB_Get_HIN_From_HINName (
       LONG   npaHandle,
       BYTE  *hinName,
       LONG  *hin
       );

Parameters

npaHandle
(IN) The HAM's handle for using the NPA APIs, assigned during NPA_Register_HAM_Module.
hinName
(IN) Points to a NULL-terminated string which represents the HIN name. The string (including the termination) can not exceed 128 characters.
hin
(OUT) HIN associated with the HIN name.

Return Values

The following table lists return values and descriptions.

0

Successful

4

Parameter error. hinName was invalid.

5

The function is not available.

Remarks

The HIN name is compared with existing HIN names in the system and the corresponding HIN is returned.