Syntax

SyncManager.CreateQueue( name, sizeLimit, alreadyExists)

Return Value

Queue

Purpose

Creates or retrieves a Queue object with the name and settings you specify.

Parameters

name As String

[In] Specifies a unique name for the Synchronization object. When the Synchronization object name begins with an asterisk, * , such as *syncobjectname , processes can share the object.

When the Synchronization object name begins with a computer name, such as \\computername\syncobjectname , you can share the object among computers, but the object resides on the computer for which you specify a name.

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.

sizeLimit As Long

[In] Specifies the maximum number of items the queue can store. A value less than or equal to zero specifies that the queue does not have a maximum number of elements.

When the alreadyExists parameter returns True to indicate a queue already exists, TestStand ignores this value.

alreadyExists As Boolean

[Out] Returns True when the Synchronization object for which you specify a name already exists.

When the object already exists, this method returns the existing object rather than creating a new object.

See Also

Queue