FindVersionedItem

Finds an item by name and version.

Synopsis

Item FindVersionedItem( int32 ctype, const char *name, uint8 vers, uint8 rev )

Description

This procedure finds an item of a specified type by its name, version number, and revision number. These values are required tag arguments for all items. If all three values match, the procedure returns the item number of the matching item.

Arguments

ctype
The type of the item to find. Use MkNodeID() to create this value.
name
The name of the item to find.
vers
The version number of the item to find.
rev
The revision number of the item to find.

Return Value

The procedure returns the number of the item that matches or an error code if an error occurs.

Implementation

Convenience call implemented in clib.lib V20.

Associated Files

item.h
ANSI C Prototype
clib.lib
ARM Link Library

Caveats

This currently returns a match if the version number and revision number are greater than or equal to the values specified.

See Also

CheckItem(), FindItem(), FindNamedItem(), LookupItem()