![]() |
UnregisterComponent |
||||
Header: | Components.h | Carbon status: | Supported | |
Removes a component from the Component Managers registration list.
OSErr UnregisterComponent ( Component aComponent );
The component to be removed. Applications that register components may obtain this identifier from the RegisterComponent or RegisterComponentResource functions. The component must not be in use by any applications or components. You can use a component instance here, but you must coerce the data type appropriately.
A result code. If there are open connections to the component, returns a validInstancesExist error.
Most components are registered at startup and remain registered until the computer is shut down. However, you may want to provide some services temporarily. In that case you dispose of the component that provides the temporary service by using this function.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)