Set_Active_Flag

#include <lvm_intr.h>

void _System Set_Active_Flag (

    ADDRESS      Partition_Handle,   /* (I) Handle of the target partition */
    BYTE         Active_Flag,        /* (I) New value of the Active Flag */
    CARDINAL32 * Error_Code          /* (O) Address where the error code will be stored */

);

Parameters

Partition_Handle

The handle of the partition whose Active Flag is to be set.

Active_Flag

The new byte value for the Active Flag.

The Active Flag indicates whether the partition is designated as 'active' in the disk partition table.

Refer to the description of the Active_Flag field under Partition_Information_Record for the allowable values.

Error_Code

The address of a CARDINAL32 in which to store an error code should an error occur.

Returns

N/A.

Errors

If Partition_Handle is not a valid handle, a trap may result.

If Partition_Handle is a volume or drive handle, then an error condition will result.

In the event of an error, this function will abort without changing any disk structures, and the value pointed to by Error_Code will be greater than 0.

Side Effects

The Active Flag for a partition may be modified.

Notes

None.

16-Bit Equivalent:

void _Far16 _Pascal _loadds SET_ACTIVE_FLAG16(
        CARDINAL32          Partition_Handle,
        BYTE                Active_Flag,
        CARDINAL32 * _Seg16 Error_Code
);