Carbon


UnregisterComponent

Header: Components.h Carbon status: Supported

Removes a component from the Component Manager’s registration list.

OSErr UnregisterComponent (
    Component aComponent
);
Parameter descriptions
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.

function result

A result code. If there are open connections to the component, returns a validInstancesExist error.

DISCUSSION

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.

AVAILABILITY

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)