MM_HJRequest

Causes and appropriate prompt to load or unload removable media.

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

Syntax

  LONG MM_HJRequest ( 
     struct InsertRequestDef  *mediaInfo, 
     LONG                     requestCode ); 
  
  

Parameters

*mediaInfo
The information in this structure identifies the media and the device to or from which the media is to be loaded our unloaded.
requestCode
Either HJ_LOAD_MESSAGE or HJ_UNLOAD_MESSAGE, indicating the type of media request.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000008

MM_OBJECT_NOT_FOUND

0x00000029

MM_CHANGER_SOURCE_EMPTY

0x0000002A

MM_CHANGER_DEST_FULL

Remarks

This API will call into applications register with Media Manager for the purpose of managing removable media expecting one of them to properly manage the handling of the removable media and then acknowledge the load or unload request by calling MM_HJMediaRequestAck. If an acknowledgment is not received, then a default request handler is used. The default request handler requires action at the server console according to the message(s) displayed there.

See Also

ApplicationRegistrationDef