MM_CreateRemovableObject

Used by the application’s Identify function to add the newly identified objects to the Media Manager database.

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

Syntax

  LONG MM_CreateRemovableObject  
     HNDL                        *mediaHandle, 
     OBID                         parentObjectID,  
     struct CreateRemovableInfoDef  *removableInfo, 
     LONG                         removableObjectType, 
     HNDL                         applicationHandle, 
     LONG                         resourceTag );

Parameters

*mediaHandle
Receives the handle of the newly created removable object.
parentObjectID
Identifies the parent of the removable object. Valid parents are read/write devices, magazines and changers. A value of -1 indicates an off-line removable object not currently associated with a parent.
*removableInfo
A pointer to a CreateRemovableInfoDef structure defining the media to be created.
removableObjectType
This defines the removable object’s type. Valid types are MM_MEDIA_OBJECT or MM_MAGAZINE_OBJECT.
applicationHandle
The application’s handle received when the application was registered with the Media Manager by calling MM_RegisterObject.
resourceTag
The resource tag returned from the AllocateResourceTag function call with MM_IO_SIGNATURE as the signature.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000001

MM_INVALID_OBJECT

Remarks

Typically this API is used in conjunction with the identification of a removable media object. This can also be used to create removable objects to represent media and/or magazines that are off line (on the shelf or otherwise not currently in the system). An application can then be aware of removable media that is not in a device or auto-loader.

See Also