Automatically Joining a Domain with a Custom Application

  • Article

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

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

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

    Property Value example Description
    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.

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

  4. Add the Component to your configuration in Target Designer.

  5. Build and deploy your run-time image.

See Also

Domain Participation | How to Create a RunOnce/Dedicated Application Run-Time Image

Last updated on Wednesday, October 18, 2006

© 2006 Microsoft Corporation. All rights reserved.