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

GetMessageHandlerInstanceContext

You can use the GetMessageHandlerInstanceContext function to retrieve data for a single instance of a handler.

void *GetMessageHandlerInstanceContext (void);

DESCRIPTION

The GetMessageHandlerInstanceContext function returns the data that you stored using the SetMessageHandlerInstanceContext function. This function returns the data that was stored by the instance of a handler that is calling the GetMessageHandlerInstanceContext function.

If the SetMessageHandlerInstanceContext function has not been previously called, the GetMessageHandlerInstanceContext function will return nil. If a constant, handle, or pointer to other data has been stored, the GetMessageHandlerInstanceContext function returns the stored data.

SEE ALSO

The SetMessageHandlerInstanceContext function is described in the previous section.

To define common data that can be used by multiple handlers, 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 GetMessageHandlerInstanceContext 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.