Prt.LocateItem (Method)

Syntax

Prt.LocateItem itemId$, [refId$ [, numRetries]]

Description

Locates a serialized Item within PRT. On return, the total Item count can be obtained from ItemCount, and the individual Items may be accessed via the Item function.

Parameter Description
itemId$ String. The Item ID to locate, may be an empty string if refId$ is specified.
refId$ String. The Reference ID of the item to locate, may omitted or an empty string if itemId$ is specified.
NumRetries Integer (optional) - The number of times to retry to find the item before failing. If an item is in transition from one tracking region to the next, there is a small period of time when it doesn't appear in either regions tracking queue. Defaults to 3 if not specified.

Example

Dim prt as new Prt
' Get a single item from PRT with its RefId
'    and display its ItemId in a message box.
PRT.LocateItem "",REFNUM$
MsgBox prt.Item(0).ItemId