Sun Microsystems VIRTUALBOX VERSION 3.1.0_BETA2 - Manual (Page 139)

9 Advanced 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