MM_CreateHotFix

Creates a redirection area for the partition selected. If one already exists, it will first be deleted. A Hot Fix object is also created in the Media Manager database by this function.

Local Servers:Blocking
Remote Servers:Blocking
NetWare Server: 5.x
Platform:DOS, NLM, OS/2, Windows* 3.1, Windows NT*, Windows*95
Service:Media Manager

Syntax

  LONG MM_CreateHotFix ( 
     LONG   partitionObjectHandle, 
     LONG   dataSize, 
     LONG  *newHotFixObjectID );

Parameters

partitionObjectHandle
The Media Manager object handle of the reserved partition object where the Hot Fix area will be created.
dataSize
The number of sectors to be contained in the usable data portion of the Hot Fix object.
newHotFixObjectID
A pointer to the Media Manager object ID of the Hot Fix object created by this function.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000001

MM_INVALID_OBJECT

0x00000005

MM_INVALID_MODE

0x00000016

MM_PARAMETER_ERROR

0xFFFFFFFF

MM_FAILURE

Remarks

Currently the maximum size for the redirection area is 120 megabytes. Any request for a redirection size greater than that amount will be truncated at 120 megabytes. However, the size of the data portion of the partition will contain the requested size.

The data size of a currently defined Hot Fix object can be found by reading the capacity parameter in the Media Manager IOObjectGenericInfoDef structure for the Hot Fix object.