PrlDisk_SwitchToState Function

Reverts a virtual disk to the specified snapshot.

Syntax

PRL_RESULT PrlDisk_SwitchToState(
    const PRL_HANDLE Handle, 
    PRL_CONST_STR pDirectoryName, 
    PRL_CONST_GUID_PTR pUid, 
    const PRL_STATES_CALLBACK pCallback, 
    PRL_VOID_PTR pParameter
);

File

PrlDisk.h

Parameters

Handle

A handle of type PHT_VIRTUAL_DISK identifying the virtual disk.

pDirectoryName

Directory name. This parameter is not currently used.

pUid

The universally unique ID (UUID) assigned to the disk. Use the PrlDisk_GetSnapshotsTree function to obtain the snapshot tree with UUIDs of individual snapshots.

pCallback

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.