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

Page 139
Image 139
Sun Microsystems VERSION 3.1.0_BETA2 user manual Custom external Vrdp authentication