Automatically Joining a Domain with a Custom Application

Article
10/07/2008

5/10/2007

You can automatically join your run-time image to a domain when a user logs on to the system. You can create a custom domain participation tool, by using Component Designer, that will automate the tool to run when a user logs on to the system. For information about using domain participation system calls, see Domain Participation Tools.

To create a custom application that joins the system to a domain

In Component Designer, create a new component for your custom application. For more information, see Creating a Component in Windows XP Embedded Studio Help.

Add a RunOnce request to your component. For more information, see Running an Application Automatically.

The following table shows the properties to set in the Extended Properties box.

FilePath

Path to the application, for example: %11%\MyApp.exe

Sets the path to your application.

Flags

0 = Run

1 = RunOnce (Default)

2 = RunOnceEx

Specifies how the process runs.

ValueName

Any character string

Specifies the name of the command to run.

If you add your application to the Run registry key, it runs every time someone logs on to the system. The application should remove the Run registry key entry once it has executed for the first time.

Additionally, you can run your custom domain participation application during FBA by adding an FBA generic command to your component. For more information about FBA generic commands, see Adding a Custom Resource to a Component in Windows XP Embedded Studio Help.

The following table shows the properties to set for the FBA generic command in the Extended Properties box.

Property	Value example	Description
FilePath	Path to the application, for example: %11%\MyApp.exe	Sets the path to your application.
Phase	20000	Sets the application to launch at the end of the FBA process.
Reboot	TRUE	If set to TRUE, FBA reboots the target system once the application exits successfully.

Add the Component to your configuration in Target Designer.
Build and deploy your run-time image.

In Component Designer, create a new component for your custom application. For more information, see Creating a Component in Windows XP Embedded Studio Help.