|
PipeExec 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.
PipeExec Configuration Settings | | | LogonType:
Specifies the logon type when starting a process as another user.This setting specifies the logon type to use when starting a process as another user.
If User is set, LogonType must also be set. If User is not set, this value will be ignored. Possible values are:
| | 2 | LOGON32_LOGON_INTERACTIVE | 3 | LOGON32_LOGON_NETWORK | 4 | LOGON32_LOGON_BATCH | 5 | LOGON32_LOGON_SERVICE | 7 | LOGON32_LOGON_UNLOCK | 8 | LOGON32_LOGON_NETWORK_CLEARTEXT | 9 | LOGON32_LOGON_NEW_CREDENTIALS |
| | Password:
Specifies the password when starting a process as another user.This setting specifies the password to use when starting a process as another user.
If User is set, Password must also be set. If User is not set, this value will be ignored.
| | ProcessId:
Returns the Id of the process which was started.This setting may be queried after calling StartProcess and will return the Id of the process which was started. This may be useful for inspecting or monitoring the process outside of the component.
| | ProcessStartupFlags:
Specifies the flags used when starting the process in Windows.This setting specifies the Windows defined flags used when creating the process.
The default value is 0x00000101 which includes the STARTF_USESTDHANDLES and STARTF_USESHOWWINDOW flags.
This may be set to the binary 'OR' of one or more of the following values:
| | 0x00000040 | STARTF_FORCEONFEEDBACK | 0x00000080 | STARTF_FORCEOFFFEEDBACK | 0x00002000 | STARTF_PREVENTPINNING | 0x00000020 | STARTF_RUNFULLSCREEN | 0x00001000 | STARTF_TITLEISAPPID | 0x00000800 | STARTF_TITLEISLINKNAME | 0x00000008 | STARTF_USECOUNTCHARS | 0x00000010 | STARTF_USEFILLATTRIBUTE | 0x00000200 | STARTF_USEHOTKEY | 0x00000004 | STARTF_USEPOSITION | 0x00000001 (default) | STARTF_USESHOWWINDOW | 0x00000002 | STARTF_USESIZE | 0x00000100 (default) | STARTF_USESTDHANDLES |
| | ProcessWindowStyle:
Specifies the window style when STARTF_USESHOWWINDOW is specified.When ProcessStartupFlags is set to include the STARTF_USESHOWWINDOW flag this setting specifies the window style that is used.
The default value is 0 (SW_HIDE). Possible values are:
| | 0 (default) | SW_HIDE | 1 | SW_SHOWNORMAL | 2 | SW_SHOWMINIMIZED | 3 | SW_SHOWMAXIMIZED | 4 | SW_SHOWNOACTIVATE | 5 | SW_SHOW | 6 | SW_MINIMIZE | 7 | SW_SHOWMINNOACTIVE | 8 | SW_SHOWNA | 9 | SW_RESTORE | 10 | SW_SHOWDEFAULT | 11 | SW_FORCEMINIMIZE |
| | User:
Specifies the user when starting a process as another user.This setting specifies the user to impersonate when starting a process as another user. If User is set, Password and LogonType must also be set.
|
Base Configuration Settings | | | BuildInfo:
Information about the product's build.When queried, this setting will return a string containing information about the product's build.
| | 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.
| | LicenseInfo:
Information about the current license.When queried, this setting will return a string containing information about the license this instance of a component is using. It will return the following information:
- Product: The product the license is for.
- Product Key: The key the license was generated from.
- License Source: Where the license was found (e.g. RuntimeLicense, License File).
- License Type: The type of license installed (e.g. Royalty Free, Single Server).
| | UseInternalSecurityAPI:
Tells the component whether or not to use the system security libraries or an internal implementation.
By default the component will use the system security libraries to perform cryptographic functions.
When set to False 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 implementation
instead of using the system's security API.
Note: This setting is static. The value set is applicable to all components used in the application.
When this value is set the product's system DLL is no longer required as a reference, as all unmanaged code is
stored in that file.
|
|