Previous

Next

Function RTFSplitGPTPartition

RTFSplitPartition splits the last partition in a partition table into two partitions:

int RTFSplitGPTPartition(void          * GPT, 
                         RTFSector       Sectors, 
                         UINT            SectorSize, 
                         UINT            PartitionAlignment, 
                         const BYTE    * Unique, 
                         const wchar_t * Name, 
                         DWORD           Flags);

RTFSplitGPTPartition does not access any physical disk.

Parameters

GPT

A pointer to a buffer holding the GPT. This parameter should have been passed to RTFCreateGPTPartition before.

Sectors

Specifies how many sectors to allocate to the currently last partition. It must be less than the number of sectors it currently has. All remaining sectors are then allocated to a new partition.

SectorSize

Bytes per sector of the disk. This value must be at least 512 and a power of two.

PartitionAlignment

Minimum alignment of the new partition. This value must be at least 1 and a power of two.

Unique

A pointer to an array of 6 bytes which uniquely identify the computer on which this function is called. This value is required to build a GUID for the new partition. If this computer has an Ethernet interface, a pointer to the Ethernet address (MAC address) of that interface should be used. Other possibilities would be the serial number of the BIOS.

Name

A pointer to a NUL-terminated Unicode name of the new partition. The maximum length is 35 characters. If this parameter is NULL, a default name will be applied.

Flags

Can be 0 or a combination of the following flags:

return value

If the function succeeds, the return value is >= RTF_NO_ERROR. If the function fails, the return value is a negative error code.

Demo program PartDemo uses this function.

Function RTFCreateGPTPartition

Function RTFCreateBackupGPT