FindAndOpenNamedItem

Finds an item by name and opens it.

Synopsis

Item FindAndOpenNamedItem( int32 ctype, const char *name )

Description

This procedure finds an item of the specified type whose name matches the name argument. The search is not case-sensitive (that is, the kernel does not distinguish uppercase and lowercase letters in item names). When an item is found, it is automatically opened and prepared for use.

Arguments

ctype
The type of the item to find. Use MkNodeID() to create this value.
name
The name of the item to find.

Return Value

The procedure returns the number of the item that was opened. It returns an error code if an error occurs.

Implementation

Convenience call implemented in clib.lib V24.

Associated Files

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

See Also

FindAndOpenItem()