MM_ReturnObjectHandle

Used to obtain the handle of an object created by the application.

Local Servers:Blocking
NetWare Server: 5.x
Platform:NLM
Service:Media Manager

Syntax

  LONG MM_ReturnObjectHandle (  
     OBID   objectID,  
     HNDL   applicationHandle,  
     HNDL  *handle );

Parameters

objectID
The OBID of the object created by the application.
applicationHandle
The handle of the requested application.
*handle
Points to where the handle will be copied.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

The handle was successfully obtained.

0x00000001

MM_INVALID_OBJECT

objectID is invalid.

0x00000016

MM_PARAMETER_ERROR

*handle is NULL

0x0000020A

MM_INVALID_HANDLE

applicationHandle is invalid.

0xFFFFFFFF

MM_FAILURE

The application is not the creator of the object.