Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 6 - Component Manager / Component Manager Reference

Routines for Components / Managing Component Connections

SetComponentInstanceA5

The SetComponentInstanceA5 procedure allows your component to set the A5 world for a connection.

PROCEDURE SetComponentInstanceA5 
         (aComponentInstance: ComponentInstance; theA5: LongInt);

aComponentInstance

The connection for which to set the A5 world. The Component Manager provides a component instance to your component when the connection is opened.

theA5

The value of the A5 register for the connection. The Component Manager sets the A5 register to this value automatically, and it restores the previous A5 value when your component returns to the Component Manager.

DESCRIPTION

The SetComponentInstanceA5 procedure sets the A5 world for the specified component instance. Once you set the A5 world for a connection, the Component Manager automatically switches the contents of the A5 register when your component receives a request over that connection. When your component returns to the Component Manager, the Component Manager restores your client's A5 value.

If your component has been registered globally and you have not set an A5 value, the A5 register is set to 0. In this case you should set the A5 world of your component instance to your client's A5 value by using SetComponentInstanceA5.

In general, your component uses this procedure only if it is registered globally; in this case, it typically calls SetComponentInstanceA5 when processing the open request for a new connection.