Important: The information in this document is obsolete and should not be used for new development.
GetMessageHandlerClassContextYou can use the
GetMessageHandlerClassContextfunction to allow multiple instances of your handler to retrieve common global data.
void *GetMessageHandlerClassContext (void);
GetMessageHandlerClassContextfunction returns common data that you defined using the
SetMessageHandlerClassContextfunction. This function can be called by any instance of your handler.
SetMessageHandlerClassContextfunction has not been previously called, the
GetMessageHandlerClassContextfunction will return
nil. If a constant, handle, or pointer has been stored, the
GetMessageHandlerClassContextfunction returns the stored data. This function may be used by your handler to allow multiple print jobs to share common global data.
SEE ALSOTo store the data that is retrieved by the
GetMessageHandlerClassContextfunction, use the
SetMessageHandlerClassContextfunction described in the previous section.
The use of the
GetMessageHandlerClassContextfunction is described in the section "Setting and Getting Global Data for Multiple Handler Instances" beginning on page 6-12.
To store data that can be used by only one instance of a handler, use the
SetMessageHandlerInstanceContextfunction described on page 6-19. To retrieve the data that has been set, use the
GetMessageHandlerInstanceContextfunction 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.