PrlDisk_DecreaseCapacity Function

Allows to decrease the size of an existing virtual disk.

Syntax

PRL_RESULT PrlDisk_DecreaseCapacity(
    const PRL_HANDLE Handle, 
    const PRL_UINT64 uiSize, 
    const PRL_DISK_CALLBACK pDiskCallback, 
    PRL_VOID_PTR pParameter
);

File

PrlDisk.h

Parameters

Handle

A handle of type PHT_VIRTUAL_DISK identifying the virtual disk.

uiSize

New overall disk size in sectors.

pDiskCallback

A pointer to a callback function or NULL pointer. If the parameter contains a valid pointer to the callback, the function will be called asynchronously. If it contains a NULL pointer, the function will be called synchronously.

pParameter

A pointer to a buffer containing user-defined data to pass to the callback function.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid argument values.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

Depending on the new disk size, the size of the last storage segment in the virtual disk storage list will be adjusted or one (or more) storages will be deleted from the end of the list.