Collapse All
Virtuozzo Virtualization SDK C API Reference
PrlSrv_LoginLocal Function
PHT_SERVER  Example  See Also

Allows to log in to the local Virtuozzo Service (the Virtuozzo Service running on this host) using the current user credentials.

PRL_HANDLE PrlSrv_LoginLocal(
    PRL_HANDLE hServer, 
    PRL_CONST_STR sPrevSessionUuid, 
    PRL_UINT32 port, 
    PRL_SECURITY_LEVEL security_level



A handle of type PHT_SERVER identifying the Virtuozzo Service.
Previous session ID. This is an optional parameter that can be used in recovering from a lost Virtuozzo Service connection. The ID will be used to restore references to the tasks that were initiated in the previous session and are still running inside the Virtuozzo Service. You can pass a null or an empty string value if you are not restoring any references. See PrlSrv_AttachToLostTask for more information.
Port number. Specify 0 (zero) to use the default port.
Communication security level to use for this connection. The security level set here will be used for all communications with the Virtuozzo Service for the duration of this session. The minimum allowable security level can be determined using the PrlDispCfg_GetMinSecurityLevel function.
A bitset of flags. Allowed next values: 

0 - no flags. It's behaviour by default ( as PrlSrv_LoginLocal() )

to use non-interactive mode. In interactive mode, a client may receive questions from the Virtuozzo Service, which it is expected to answer in order for the operation to continue. In non-interactive mode, the Virtuozzo Service will make decisions on its own.


A handle of type PHT_JOB containing the results of this asynchronous operation, including the return code and a handle of type PHT_LOGIN_RESPONSE, containing an additional Virtuozzo Service information. 

PRL_INVALID_HANDLE if there's not enough memory to instantiate the job object. 


When performing a local login operation, no password/username is needed. The authentication and authorization will be performed using the current user account. 

To get the return code from the PHT_JOB object, use the PrlJob_GetRetCode function. Possible values are: 

PRL_ERR_INVALID_ARG - invalid handle was passed. 

PRL_ERR_SUCCESS - function completed successfully. 

To get the results from the PHT_JOB object:

  1. Use the PrlJob_GetResult function to obtain a handle to the PHT_RESULT object.
  2. Use the PrlResult_GetParam function to obtain a handle of type PHT_LOGIN_RESPONSE.

See Also

The following example illustrates how to log in to locally running Virtuozzo Service and to obtain a handle of type PHT_LOGIN_RESPONSE.

// Log in.
hJob = PrlSrv_LoginLocal( hServer, NULL, 0, PSL_LOW_SECURITY );
PrlJob_Wait( hJob, 10000 );

// Get the results of the login operation.
PrlJob_GetResult( hJob, &hJobResult );
PrlHandle_Free( hJob );

// Get the PHT_LOGIN_RESPONSE handle from the job result.
PrlResult_GetParam( hJobResult, &hHandle );
Copyright ©2016-2017 Parallels International GmbH. All rights reserved.