Inside Macintosh: Apple Game Sprockets Guide /

Chapter 4 - NetSprocket / NetSprocket Reference

Constants

Network Message Priority Flags

These constants are used to identify various priorities you may assign to network messages using a mail service metaphor. You use these flags in the NSpFlags parameter of the NSpMessage_Send function (page 4-50).

enum {
   kNSpJunk                = 0x10000000,
   kNSpNormal              = 0x20000000,
   kNSpRegistered          = 0x30000000
};

Constant descriptions

kNSpJunk

This message is junk mail. This type of message will be sent only when no other messages of higher priority are pending. This is essentially a "fire and forget" message. Delivery will only be attempted once, and there is no guarantee of receipt.

kNSpNormal

This message is an ordinary, every-day message. It will be sent immediately, but like kNSpJunk, delivery will only be attempted once, and there is no guarantee of receipt.

kNSpRegistered

Like registered mail, this message is quite important. Delivery is of the highest priority. For example, if kNSpNormal or kNSpJunk messages are being sent (or if a message is being chunked for delivery in multiple packets), they will be interrupted in favor of a kNSpRegistered message. NetSprocket will demand proof of receipt and will continue retrying until the maximum retry limit has been exceeded.