Inside Macintosh: Apple Game Sprockets Guide /

Chapter 4 - NetSprocket / NetSprocket Reference

NetSprocket Functions / Hosting and Joining a Game

NSpGame_EnableAdvertising

You can use the NSpGame_EnableAdvertising function to enable or disable advertising.

OSStatus NSpGame_EnableAdvertising (
	NSpGameReference inGame,
	NSpProtocolReference inProtocol,
	Boolean inEnable);

inGame

An opaque reference to your game object.

inProtocol

An opaque reference to a protocol for which you wish to stop advertising, or NULL to stop advertising on all protocols.

inEnable

A value of true to start advertising or false to stop advertising.

function result

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

DESCRIPTION

You should set the inEnable parameter to true or false, depending on whether you want to start advertising or stop advertising. The NSpGame_Host function automatically advertises the game, unless you passed kNSpGameFlag_DontAdvertise in its inFlags field.