Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 6 - Message Manager / Message Manager Reference

Functions / Setting and Getting Global Data for Multiple Handler Instances

SetMessageHandlerClassContext

You can use the SetMessageHandlerClassContext function to store data that can be used by multiple instances of a message handler.

void *SetMessageHandlerClassContext (void *);

DESCRIPTION

The SetMessageHandlerClassContext function is used to store data that can be used by multiple instances of a message handler in one or more print jobs. The parameter passed is a pointer to the long data. The stored data can be in the form of a constant, handle, or pointer to additional data. This reference constant can be used by all instances of a message handler.

SEE ALSO

To retrieve the data defined by the SetMessageHandlerClassContext function, use the GetMessageHandlerClassContext function described in the next section.

The use of the SetMessageHandlerClassContext function is described in the section "Setting and Getting Global Data for Multiple Handler Instances" beginning on page 6-12.

To define data that can be used by only one handler, use the SetMessageHandlerInstanceContext function described on page 6-19. To retrieve the data that has been set, use the GetMessageHandlerInstanceContext function described on page 6-20.

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