Syntax

Engine.AcquireLicense( license, options)

Return Value

Long

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 the Engine.ReleaseLicense method using the handle this method returns. An application requires a type of license until you release all license handles for the license type.

Remarks

If TestStand cannot acquire the license and you do not pass AcquireLicenseOption_SuppressStartupDialog to the options parameter, TestStand launches a dialog box that prompts you to evaluate, activate, or purchase TestStand. This method returns an error if TestStand cannot acquire the required license.

The Application Manager control automatically calls this method when you call the ApplicationMgr.Start method. 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] Specifies one or more AcquireLicenseOptions options.

See Also

Activating Your Software with the NI License Manager

AcquireLicenseOptions

ApplicationLicenses

ApplicationMgr.IsEditor

ApplicationMgr.Start

Engine.ReleaseLicense

TestStand Licensing Options