HAI_Return_Device_ObjectID

Returns the Media Manager Object ID for a specific device.

Thread Context:Non-Blocking

Syntax

    LONG HAI_Return_Device_ObjectID (
       LONG   npaBusHandle,
       LONG   deviceHandle,
       LONG  *objectID
    );
    
    

Parameters

npaBusHandle
(IN) NWPA-generated handle to the target bus. This parameter was passed to the HAM from HAI_Activate_Bus when the bus was activated.
deviceHandle
HAM-generated handle to the device that was passed back in the DeviceInfoStruct during initial and subsequent scans.
objectID
(OUT) The Media Manager Object ID for the selected device.

Return Values

The following table lists return values and descriptions.

zero

Successful

nonzero

Failed to return Object ID.

Remarks

HAI_Return_Device_ObjectID provides a means for a HAM to obtain the Media Manager Object ID associated with a selected device. For more details, refer to the NDK: Media Manager for NetWare 5.x and 6.x documentation.