Sun Microsystems VERSION 3.1.0_BETA2 user manual Custom external Vrdp authentication

9Advanced topics

•/VirtualBox/HostGuest/SysprepRet holds the exit code of sysprep.exe after its run.

•/VirtualBox/HostGuest/SysprepRC holds the return code of the whole system preparation process done by VBoxService.exe.

The sysprep execution is a sub-service in VBoxService.exe which will be run every 10 seconds by default. You can disable this sub-service or increase/decrease the waiting time. See the command line help by doing a VBoxService.exe --help for more information.

The following sequence shows the general behavior of the sysprep execution sub- service:

•Check for a value in guest property /VirtualBox/HostGuest/SysprepArgs

•If successful detect the sysprep.exe based on the operating system

•If sysprep.exe exists execute it with system privileges using command line arguments given with /VirtualBox/HostGuest/SysprepArgs

•Wait for sysprep.exe to finish

•Store its exit code in /VirtualBox/HostGuest/SysprepRet

In any case the overall status of the sysprep sub service will be written back to /VirtualBox/HostGuest/SysprepRC (0 on success).

To get a more verbose output of VBoxService.exe for debugging, do the follow- ing:

•Stop the running VBoxService.exe through the Windows Service Control Manager (SCM).

•Open up a console, go to %WINDIR%\System32 and start VBoxService.exe with

VBoxService.exe -f -vvv

This will start VBoxService.exe in foreground mode with verbose console logging.

9.4 Custom external VRDP authentication

As described in chapter 7.4.5, RDP authentication, page 104, VirtualBox supports arbi- trary external modules to perform authentication with its VRDP servers. When the au- thentication method is set to “external” for a particular VM, VirtualBox calls the library that was specified with VBoxManage setproperty vrdpauthlibrary. This li- brary will be loaded by the VM process on demand, i.e. when the first RDP connection is made by an external client.

139