Carbon


GetComponentInstanceStorage

Header: Components.h Carbon status: Supported

Allows your component to retrieve a handle to the memory associated with a connection.

Handle GetComponentInstanceStorage (
    ComponentInstance aComponentInstance
);
Parameter descriptions
aComponentInstance

The connection for which to retrieve the associated memory. The Component Manager provides a component instance to your component when the connection is opened. You can use a component identifier here, but you must coerce the data type appropriately.

function result

A handle to the memory associated with the specified connection.

DISCUSSION

Typically, your component does not need to use this function, because the Component Manager provides this handle to your component each time the client application requests service from this connection.

Your component tells the Component Manager about the memory associated with a connection by calling the SetComponentInstanceStorage 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)