Inside Macintosh: Apple Game Sprockets Guide /

Chapter 4 - NetSprocket / NetSprocket Reference

NetSprocket Functions / Sending and Receiving Messages

NSpInstallAsyncMessageHandler

You can use the NSpInstallAsyncMessageHandler function to install a message handler for your game object and put the messaging mechanism into asynchronous mode. You do not need to install a message handler, unless you want NetSprocket to call your handler function back as soon as a completed message has arrived.

OSStatus NSpInstallAsyncMessageHandler (
	NSpMessageHandlerProcPtr inHandler,
	void *inContext);

inHandler

A pointer to your message handling function.

inContext

A pointer that will be passed back to your handler when it is called by NetSprocket.

function result

A result code of noErr, or a NetSprocket or Open Transport result code.

DESCRIPTION

Your message handler should be in place and ready to receive messages before this function returns. NetSprocket returns an error if there was a problem installing the handler.