PrlDisk_Coagulate Function

Combines all available disk snapshots into a single entity.

Syntax

PRL_RESULT PrlDisk_Coagulate(
    const PRL_HANDLE Handle, 
    const PRL_STATES_CALLBACK pDiskCallback, 
    PRL_VOID_PTR pParameter
);

File

PrlDisk.h

Parameters

Handle

A handle of type PHT_VIRTUAL_DISK identifying the virtual disk.

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

On operation completion, the data from all existing disk snapshots will be merged and the snapshot tree will seize to exist.