Inside Macintosh: More Macintosh Toolbox /

Chapter 6 - Component Manager / Component Manager Reference

Routines for Applications / Retrieving Component Errors

GetComponentInstanceError

The GetComponentInstanceError function returns the last error generated by a specific connection to a component.

FUNCTION GetComponentInstanceError 
                  (aComponentInstance: ComponentInstance): OSErr;

aComponentInstance

A component instance that specifies the connection from which you want error information. Your application obtains the component instance from the OpenDefaultComponent or OpenComponent function.

DESCRIPTION

Once you have retrieved an error code, the Component Manager clears the error code for the connection. If you want to retain that error value, you should save it in your application's local storage.

RESULT CODES

noErr	0	No error
invalidComponentID	-3000	No component with this component identifier