Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 6 - Message Manager / Message Manager Reference

Functions / Setting and Getting Global Data for a Single Handler Instance

SetMessageHandlerInstanceContext

You can use the SetMessageHandlerInstanceContext function to store data that can be used by a single handler.

void *SetMessageHandlerInstanceContext (void *);

DESCRIPTION

The SetMessageHandlerInstanceContext function is used to store data that can be used by only a single instance of a message handler. This data is specific to your handler's code and is unique to one copy in memory. The stored data can be in the form of a long word constant, handle, or pointer to other data. The passed data can be accessed only by the instance of the message handler that sets the data.

SEE ALSO

To retrieve the data that has been set by the SetMessageHandlerInstanceContext function, use the GetMessageHandlerInstanceContext function described in the next section.

To define common data that can be used by multiple instances of a handler, use the SetMessageHandlerClassContext function described on page 6-21. To retrieve the common data that has been set, use the GetMessageHandlerClassContext function described on page 6-22.

The use of the SetMessageHandlerInstanceContext function is described in the section "Setting and Getting Global Data for a Single Handler Instance" beginning on page 6-10.

Global data is discussed in the section "Global Data Storage for Printing Extensions and Printer Drivers" beginning on page 6-7.