AcquireLicense Method
Syntax
Engine.AcquireLicense ( license, options)
Return Value
A handle to the acquired license.
Purpose
Instructs TestStand to acquire a type of license for the application. When the license is no longer required, call ReleaseLicense using the handle that this method returns. An application requires a type of license until you release all license handles for that license type.
Remarks
If TestStand cannot acquire the license and you do not pass AcquireLicenseOption_SuppressStartupDialog to the options parameter, TestStand displays a dialog box prompting to evaluate, activate, or purchase TestStand. This method throws an error if TestStand cannot acquire the required license.
The Application Manager control automatically calls this method when you call ApplicationMgr.Start. When using an Application Manager control to start the engine, set the ApplicationMgr.IsEditor property before calling ApplicationMgr.Start.
Parameters
license As ApplicationLicenses
[In] Specifies the type of license to acquire.
options As long
[In] Pass one or more AcquireLicenseOptions options.