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

RegistryEntryDelete

RegistryEntryDelete deletes a name entry from the Name Registry.



 
OSStatus RegistryEntryDelete (const RegEntryID id);

--> id: Pointer to the RegEntryID value of name entry to delete.

DESCRIPTION

Given the RegEntryID value of a name entry in the Name Registry, RegistryEntryDelete deletes it. If the name entry node is deleted, the iterator and RegEntryID are no longer valid and cannot be used for subsequent iterations.

EXECUTION CONTEXT

RegistryEntryDelete may be called only from task level.

RESULT CODES

`noErr`	0	No error
`paramErr`	-50	Bad parameter
`nrLockedErr`	-2536	Entry or property is locked
`nrInvalidNodeErr`	-2538	`RegEntryID` value not valid

Note

In the current Mac OS, all children of a parent entry are removed when the parent is removed. Removing a parent entry, thereby creating orphan entries, may not be supported in future releases.