Virtuozzo Virtualization SDK C API Reference
The PrlSrv_CommonPrefsBeginEdit function is used in modifying Virtuozzo Service preferences (see PHT_DISP_CONFIG).
The PrlSrv_CommonPrefsBeginEdit and the PrlSrv_CommonPrefsCommit functions are used to detect collisions with other clients trying to modify preferences of the same Virtuozzo Service. The PrlSrv_CommonPrefsBeginEdit call timestamps the beginning of the operation. It does not lock the Virtuozzo Service, so other clients can modify the same Virtuozzo Service settings at the same time. When you are done making the changes, you must call the PrlSrv_CommonPrefsCommit function to apply them to the Virtuozzo Service. The function will verify that the Virtuozzo Service preferences have not been modified by another client. If a collision is detected, your changes will be rejected.
PRL_ERR_INVALID_ARG - invalid handle was passed.
PRL_ERR_ACCESS_DENIED - current user does not have sufficient rights to perform this operation.
PRL_ERR_SUCCESS - function completed successfully.