MM_RegisterObject

Registers an object with the Media Manager database.

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

Syntax

  LONG MM_RegisterObject (  
     HNDL  *objectHandle, 
     LONG   class, 
     void  *objectRegistrationInfo, 
     HNDL   applicationHandle, 
     LONG   resourceTag );

Parameters

*objectHandle
An output parameter that contains the handle of a successfully registered object.
class
Defines the class that the object is to be registered with.
*objectRegistrationInfo
A pointer to a structure used to describe the object being registered. The structure is defined by the class with which the object is registered.
applicationHandle
The value acquired from MM_APPLICATION_SIGNATURE when the application registered with the Media Manager.
resourceTag
A class-specific resource tag required to register an object.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

The object was successfully registered.

0x00000001

MM_INVALID_OBJECT

The *objectRegistrationInfo was NULL or the signature inside the structure is not consistent with the resource tag.

0x00000016

MM_PARAMETER_ERROR

*objectHandleis NULL.

0x00000102

MM_INVALID_APPLICATION

applicationHandle is invalid

0x00000103

MM_INVALID_RESOURCETAG

The resource tag is invalid for the class.

0x00000207

MM_INVALID_CLASS

class does not identify a class registered with the Media Manager.

Remarks

This API returns a handle to the calling application. The handle can be used in place of the OBID in all other Media Manager APIs.

See Also