NPAB_Get_HINName_From_HIN

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

Thread Context:Non-Blocking

Syntax

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

Parameters

npaHandle
(IN) The HAM's handle for using the NPA APIs, assigned during NPA_Register_HAM_Module.
hin
(IN) The HIN for which the name is being requested.
hinName
(OUT) Points to a buffer (provided by the caller) of 128 characters that receives the NULL-terminated HIN name string.

Return Values

The following table lists return values and descriptions.

0

Successful

4

The specified HIN was invalid.

5

The function is not available.

6

No name is associated with the specified HIN.

Remarks

The HIN name can be used in displaying hardware instance information to a user.

The HIN name is uppercase and is not translatable.