|
Windows Features
This plug-in provided command configures or on the target operating system. Installation is handled directly by the underlying operating system. This plug-in assists with feature dependency selections and displays available features in a manner similar to the built-in applet itself.
Windows Version
First, select a version and platform that you wish to configure in your installation. Only those features which are available on the selected version and platform are displayed.
Next, perform your selections for the version and platform of that you selected by checking each feature to enable on the target operating system. Dependencies for selected features are automatically checked when you make your selections. Manually deselecting any automatically checked dependencies may cause this plug-in to fail.
Finally, repeat this process until you have manually configured all versions and platforms which you intend to support with your setup. Due to the different features and dependency hierarchies present in each version and platform of , it is not reliable to apply a generic configuration across more than one version and platform of .
As you configure different operating system versions and platforms, small icons will be shown next to each operating system version indicating that some platforms have been configured for that version - helping you keep track of which platforms and versions you are editing.
As of version 2.0 of this plug-in, there is no need to invoke the plug-in multiple times for different versions and platforms of , nor will the plug-in fail when it is run on a version and platform of Windows for which it had not been configured previously.
Platform
Select to configure a 32 bit operating system, or select to configure a 64 bit operating system, or select to configure an operating system. Since the operating system is virtually brand-new, it is supported only with the newest versions of the operating system, and will be grayed otherwise.
When switching platforms for the same operating system, the plug-in will prompt you whether you wish to automatically apply your selected configuration to the new platform. Any such application will be done within the limitations of the platforms being transitioned - namely, if your previously selected features are unavailable on your newly selected platform, they cannot be applied at all.
Return Result in Variable
If specified, this variable must have been previously defined in the setup script using the Set Variable command.
This variable will hold one of the following values based on the result of the configuration operation:
| Value | Meaning |
|---|---|
| SUCCESS | Installation was completed successfully. Process result will either be empty or contain one of FEATURE_UNDEFINED, INVALID_OS, INVALID_OS_ARCHITECTURE, or OS_UNDEFINED based on execution details. |
| REBOOT_REQUIRED | Installation was completed successfully, however a reboot is required. Process result will be empty. |
| FAILURE | Internal error. Process result will be one of MODULE_INTIALIZATION_FAILED, MODULE_CONFIGURATION_FAILED, TARGET_OS_ENVIRONMENT_ERROR, ENABLE_FEATURE_FAILED, FEATURE_NOT_ENABLED, UNKNOWN_OS, or IMAGE FILE_LOAD_ERROR based on execution details. |
Return Process Result in Variable
If specified, this variable must have been previously defined in the setup script using the Set Variable command.
This variable will hold one of the following values based on the result of the configuration operation:
| Value | Meaning |
|---|---|
| FEATURE_UNDEFINED | No features selected for installation. |
| INVALID_OS | Installation attempted on an unconfigured operating system. |
| INVALID_OS_ARCHITECTURE | Installation attempted on a bitwise mismatched operating system. |
| UNKNOWN_OS | Internal error, failed to reconcile operating system data. |
| TARGET_OS_ENVIRONMENT_ERROR | Internal error, unable to query target environment. |
| ENABLE_FEATURE_FAILED | An error occurred during installation. |
| FEATURE_NOT_ENABLED | Installation has failed due to a manually deselected dependency. |
| REBOOT_REQUIRED | Installation was completed successfully, however a reboot is required. |
| FEATURE_NOT_FOUND | Installation attempted on an unsupported operating system. |
| MODULE_INTIALIZATION_FAILED | Internal error, unable to initialize. |
| MODULE_CONFIGURATION_FAILED | Internal error, unable to load configuration data. |
| IMAGEFILE_LOAD_ERROR | Internal error, unable to load image data. |
| OS_UNDEFINED | No operating systems selected for installation. |
Notes
- This command uses intelligent dependency resolution based on dependencies as reported by on each target platform.
- When upgrading from older versions of this plug-in to newer versions, your setup script may contain verbiage similar to: Legacy Plugin data -> WARNING: cannot resolve OS version! In such cases, double-click each plug-in line displaying this warning. The plug-in will address the resolution automatically within a few seconds, after which clicking OK on the plug-in dialog box will save your changes to your setup script and resolve the condition permanently. This step must be repeated for each affected line in your setup script, and you must save your setup script to finalize the fixes.