Name Attribute of Synchronization Objects

TestStand 2019 Help

Edition Date: May 2019

Part Number: 370052AA-01

»View Product Info
Download Help (Windows Only)

When you create a Synchronization object, specify a unique name with a literal string or an expression that evaluates to a string to create a reference to the new Synchronization object. Because all named synchronization objects share the same name space, you cannot create synchronization objects with the same name. Synchronization object names are not case-sensitive.

When an object with the same name and type already exists, the step creates a reference to the existing Synchronization object so you can access an existing object from multiple threads or executions.

When you specify an empty string as the name for a Synchronization object, TestStand creates an unnamed Synchronization object you can access only through an object reference variable. To associate an unnamed Synchronization object with an object reference variable, select Use Object Reference as the object reference lifetime on the edit tab of the Step Settings pane for each step type.

By default, you can access a Synchronization object only from the operating system process in which you create the object. However, you can make a Synchronization object accessible from other processes, such as multiple instances of a user interface, by using an asterisk (*) as the first character in the name.

You can also create a Synchronization object on a specific computer by beginning the name of the object with the computer name, such as \\computername\syncobjectname, which you can use to access the Synchronization object from any computer on the network. To access synchronization objects on other computers, you must configure Microsoft Windows system security to allow users to launch and access the TSAutoMgr.exe server remotely.

Note Note  When you use a string constant in a dialog box expression control to specify an object on a remote computer, escape the backslashes and surround the name in quotation marks. For example, use "\\\\computername\\syncobjectname".

When the Synchronization object name begins with an asterisk or computer name, you can use a 32 or 64 prefix to specify using 32- or 64-bit TestStand to host the out of process Synchronization object. For example, the name 64*syncobj specifies a Synchronization object called *syncobj in the 64-bit TestStand host process, even when used from 32-bit TestStand. Use the prefix to share Synchronization objects between 32-bit TestStand and 64-bit TestStand in the same host process. If you do not use the prefix, 32-bit TestStand hosts out of process Synchronization objects in a 32-bit process, and 64-bit TestStand hosts out-of-process Synchronization objects in a 64-bit process.


Not Helpful