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