Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlVm_Compact Function
PHT_VIRTUAL_MACHINE

Start process of optimization of virtual hard disk.

Syntax
PRL_HANDLE PrlVm_Compact(
    PRL_HANDLE hVm, 
    PRL_UINT32 uMask, 
    PRL_UINT32 nFlags
);
File

PrlApiVm.h

Parameters

hVm
valid PRL_HANDLE describing the virtual machine
uMask
bit mask of really hard disk devices (little endian order). See PRL_HARD_DISK_IFACE_MASK enumeration for all bits.
nFlags
only bit PACF_NON_INTERACTIVE_MODE is used. Others bits are reserved

Returns

PRL_HANDLE to job that describing async operation result (PRL_INVALID_HANDLE means not enough memory to instantiate async job represents object handle). Operation return code can be extracted with @ref PrlJob_GetRetCode() call. Possible values: PRL_ERR_INVALID_ARG - non valid PHT_VIRTUAL_MACHINE handle was passed PRL_ERR_UNINITIALIZED - unexpected error: uninitialized with server connection or non identified VM object

Remarks

The machine should be registered on the server to do that.

Links
© 2021 Parallels International GmbH. All rights reserved.