FBA Generic Command (Windows Embedded Standard 2009)

4/23/2012

This resource is required for a component that needs programs executed at first boot of the run-time image. First Boot Agent (FBA) calls the Win32 CreateProcess function to run a program and optionally pass it command-line arguments.

The following extended properties can be set for the FBA Generic Command resource in Component Designer or in Target Designer.

  • Arguments

    Type Required or optional

    String

    Optional

    Used to pass command-line arguments to a program run by FBA. Arguments containing paths should use environment variables in path names. For more information, see Predefined System Environment Variables.

    The default value is an empty string.

  • ComponentVSGUID

    Type Required or optional

    GUID

    Not applicable

    Reserved for Microsoft.

  • ErrorControl

    Type Required or optional

    Integer

    Required

    Controls how FBA handles errors when executing a program.

    • 0: Continue on error. Default.
    • 1: Halt on error.

    If the CreateProcess return value or the process exit code is greater than 0x80000000, then FBA considers this an error and behaves according to the value of this property.

  • Filepath

    Type Required or optional

    String

    Required

    Specifies the name of the program to be executed. This value must be a fully qualified path, for example, %11%\cmd.exe. Use environment variables in path names. For more information, see Predefined System Environment Variables.

  • Flags

    Type Required or optional

    Integer

    Required

    Supports the following flags:

    • 0: Create the process and wait timeout seconds for it to exit before continuing. Default.
    • 1: Create the process and continue.
  • REBOOT

    Type Required or optional

    Boolean

    Required

    Specifies if a reboot is required following the completion of the FBA operation.

    • True: FBA completes its operation, reboots, and then continues.
    • False: FBA continues to process without rebooting. Default.
  • START

    Type Required or optional

    Integer

    Not applicable

    Reserved for Microsoft. Must be 1.

  • TIMEOUT

    Type Required or optional

    Integer

    Required

    Specifies the time, in seconds, that a program is allowed to execute before being terminated by FBA.

    The default value of 0 indicates an infinite number of seconds. This value is ignored if Flags is 1.

  • Type

    Type Required or optional

    Integer

    Required

    Reserved for Microsoft. Must be 1.

  • Phase

    Type Required or optional

    Integer

    Required

    Determines the time during FBA processing at which the command runs.

    Note

    t You must specify a phase that is above the 0-8500 system-reserved phase range.

    In most cases, the value should be set at 8501. If the processing needs to occur after cloning, the value should be set at 12000.

The following examples show how to use the FBA Generic Command to call a DLL entry point using Rundll32.exe.

The following command shows how to run Rundll32.exe.

Rundll32.exe <dllname>,<entrypoint>,<optional arguments>

The following command shows how to use the command.

Rundll32.exe Setupx.dll,InstallHinfSection 132 C:\Windows\Inf\Shell.inf

Using this example, set the following FBA Generic Command parameters as follows:

  • Filepath: %11%\Rundll32.exe
  • Arguments: Setupx.dll,InstallHinfSection 132 C:\Windows\Inf\Shell.inf

See Also

Other Resources

Custom Resources