DLL.DefineEnvironment method defines a new environment for loading dynamic link libraries with the desired “bitness” and calling their routines. By defining an environment, the method also defines the “bitness” of the corresponding hosting process (tcHostingProcess.exe), into which TestComplete will load the libraries. Note that the
DLL.DefineEnvironment method does not create the hosting process itself. The process with the specified “bitness” will be created later on demand (for instance, when you call the
|IsX86||[in]||Optional||Boolean||Default value: True|
The method is applied to the following object:
The method has the following parameter:
Specifies whether a 32-bit or a 64-bit environment will be defined by the method. If the parameter is True (the default value), a 32-bit environment is defined and a 32-bit hosting process will be created later for loading DLLs. If the parameter is False, the method defines a 64-bit environment and a 64-bit hosting process will be created.
IDLLAccessProcess object that provides methods for defining DLL types, loading DLLs in memory, defining new data types for routine parameters and creating new instances of these data types in the created environment.
The maximum number of hosting processes (and corresponding environments) created by TestComplete for DLL loading is two (one 32-bit process for 32-bit libraries and one 64-bit process for 64-bit libraries). If you try to call the
DefineEnvironment method twice or more times with the same parameter value (that is, if you try to define more than one environment with the same “bitness”), the method will not create a new environment and will return a reference to the same
IDLLAccessProcess object created before. You can define only one 32-bit environment and only one 64-bit environment in one script.
To view an example that demonstrates how to use the
DefineEnvironment method, see Specifics of Using 32- and 64-bit DLLs.