PrlDispCfg_SetCanChangeDefaultSettings Function

Allows to grant or deny a permission to new users to modify Virtuozzo Service preferences.

Syntax

PRL_RESULT PrlDispCfg_SetCanChangeDefaultSettings(
    PRL_HANDLE hDispConfig, 
    PRL_BOOL bDefaultChangeSettings
);

File

PrlApiDisp.h

Parameters

hDispConfig

A handle of type PHT_DISP_CONFIG.

bDefaultChangeSettings

If set to PRL_TRUE, new users will be allowed to modify Virtuozzo Service preferences. If set to PRL_FALSE, new users will not be allowed to make such modifications.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

By default, only administrators of the host OS can modify Virtuozzo Service preferences. When a new Virtuozzo Service user profile is created (this happens when a user logs on to the Virtuozzo Service for the first time), he/she will be granted or denied this privilege based on the default setting. This function allows to set that default setting. To determine the current behavior, use PrlDispCfg_CanChangeDefaultSettings. Please note that this function only affects the new users (the users that will be created in the future). The profiles of the existing users will not (and cannot) be modified.