PATH ADC Home > Documentation > Hardware > Device Managers and Drivers > PCI Card Services > Designing PCI Cards and Drivers for Power Macintosh Computers

RegistryEntryIterateSet

RegistryEntryIterateSet sets a cookie value to identify a specified starting name entry.



 
OSStatus RegistryEntryIterateSet(

                     RegEntryIter *cookie,

                     const RegEntryID *startEntryID);

--> cookie: Pointer to iterator used by iterate and search routines.
--> startEntryID: Pointer to the RegEntryID value that identifies the name entry to start iteration.

DESCRIPTION

When an iterator is first created, it is set to the root of the Name Registry with a relation of kRegIterDescendants. RegistryEntryIterateSet lets you adjust this starting point to a known name entry so you can iterate or search over a subset of the device tree.

The relation part of the iterator can be set by specifying a new relation in a subsequent iterate or search call.

EXECUTION CONTEXT

RegistryEntryIterateSet may be called only from task level.

RESULT CODES

`noErr`	0	No error
`paramErr`	-50	Bad parameter
`nrInvalidNodeErr`	-2538	`RegEntryID` value not valid