Important: The information in this document is obsolete and should not be used for new development.
ForwardMessageYou can use the
ForwardMessagefunction to specify the message to be forwarded to the next message handler.
OSErr ForwardMessage (long messageSelector,...);
- The number of the message to be forwarded.
- additional parameters
Parameters associated with the message sent.
- function result
- An error of type
ForwardMessagefunction forwards the message specified by the
messageSelectorparameter to the next message handler. This function is like the
ForwardThisMessagefunction, except that any message may be forwarded. The
messageSelectorparameter indicates which message is to be forwarded, as in the
SendMessagefunction. By definition, all messages return a function result of type
The ellipsis character at the end of the parameter list indicates that the remaining additional parameters are unspecified; the caller must pass whatever parameters are expected by the recipient of the message identified by the
messageSelectorparameter. By definition, all message overrides return a result of type
OSErr. It is an error to call the
ForwardMessagefunction except from within a message handler. In any other case, behavior is undefined.
OSErrerror returned may indicate that the message could not be forwarded. If no error occurs, the function result is
noErr. In addition, the receiving message handler may return an error of type
SEE ALSOTo send a specified message to the current message target, use the
SendMessagefunction described in the previous section.
To forward the current message to the next message handler, use the
ForwardThisMessagefunction described in the next section.
The use of the
ForwardMessagefunction is described in the section "Sending and Forwarding Messages" beginning on page 6-15.