SDA Configuration
The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.
SDA Configuration Settings
| CompleteMessage: Message to notify user that extraction has finished normally. When the self-decrypting executable created by this component successfully finishes extracting the files contained within itself, it may optionally display a Message Box indicating that it's finished. By default, the message "Extraction Complete." is displayed. You may change this to your own custom message. However, any message longer than 400 characters will be truncated. To disable this message, set the CompleteMessage configuration setting to "" (empty string). | |||||||||
| ExtractorStub: Path to optional self-extractor executable stub.
Normally the component loads a self-extractor stub from an internal resource
and uses it to create the self-decrypting executable.
If a path is specified in this setting, the file indicated by that path is used instead. This setting allows you to specify a custom self-extractor. The compiled self-extractor stub is available on demand. Resources such as icons and text may then be modified. This may also be used to specify if the resulting executable should be 32 bit or 64 bit by setting this to either "*32bit" or "*64bit". | |||||||||
| FileToExecuteParams: List of parameters to pass to FileToExecute.This setting allows you to pass command-line parameters to the executable file indicated by FileToExecute. Parameters should be in the form of a space-separated list. | |||||||||
| InstallationMode: This setting will install to ExtractToPath, run FileToExecute, and then remove the extracted files. Is set to true, this setting makes the self-extractor behave as an installer by installing to a temp directory, running the desired executable, and removing the extracted files upon completion. The default value is false. | |||||||||
LogLevel: Specifies the level of detail that is logged.This setting controls the level of detail that is logged through the Status event. Possible values are:
| |||||||||
| RequireAdminPrivs: Specifies whether the created executable requires Administrator privileges.This setting specifies whether the executable created by the component requires Administrator privileges to execute.
This setting is false by default. | |||||||||
| SilentExtraction: Specifies whether the archive should hide all UI interaction while extracting.This setting specifies whether to hide the progress bar and success window when the archive executable is run.
Setting this config to true is equivalent to passing the '/s' command-line parameter to the archive executable.
This setting is false by default. |
Base Configuration Settings
| GUIAvailable: Tells the component whether or not a message loop is available for processing events.
In a GUI-based application, long-running blocking operations may cause the application to stop responding to input until the operation returns. The component will attempt to discover whether or not the application has a message loop and, if one is discovered, it will process events in that message loop during any such blocking operation.
In some non-GUI applications an invalid message loop may be discovered that will result in errant behavior. In these cases, setting GuiAvailable to false will ensure that the component does not attempt to process external events. | |
| UseBackgroundThread: Whether threads created by the component are background threads.If set to True, when the component creates a thread the thread's IsBackground property will be explicitly set to True. By default this setting is False. | |
| UseManagedSecurityAPI: Tells the component whether or not to use the system security libraries or a managed implementation.
By default the component will use the system security libraries to perform cryptographic functions. This means
calls to unmanaged code will be made. In certain environments this is not desirable. To use a completely managed security
implementation set this setting to True. Setting this to True tells the component to use the internal managed implementation
instead of using the system's security API.
Note that when this value is set the product's system dll is no longer required as a reference, as all unmanaged code is stored in this file. |