PrtService.LocateItem (Method)

Syntax

PrtService.LocateItem itemId, refId [, numRetries]

Description

Locates a serialized item within the tracking service. Upon return, the total item count may 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 ServiceA as new PrtService

ServiceA.Id = "SERVICEA_DC"

' Get a single item from a region with its RefId and display

'   its ItemId in a message box.

ServiceA.LocateItem "",REFNUM$

MsgBox ServiceA.Item(0).ItemId

More information

PRT Object Model member list.