MM_InitializePartitionTable

Clears the partition table and makes it ready for its first partition to be defined.

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_InitializePartitionTable (  
     LONG   deviceObjectHandle );

Parameters

deviceObjectHandle
The Media Manager object handle of a reserved device object.

Return Values

The following table lists return values and descriptions.

0x00000000

MM_OK

0x00000001

MM_INVALID_0BJECT

0x00000005

MM_INVALID_MODE

0x00000006

MM_RESERVATION_CONFLICT

0xFFFFFFFF

MM_FAILURE

Remarks

In the IBM partitioning scheme this will NULL sector 0 of the media, leaving the partition signature [0xAA55].

This function will deactivate partition objects that are child objects of the device. It will also remove the associated partition objects from the Media Manager database.