$#K SNETPROGRAMDATA

The SNETPROGRAMDATA structure contains information about the application, such as the program name and version number.

typedef struct _SNETPROGRAMDATA {
	DWORD		size;
	LPCSTR	programname;
	LPCSTR	programdescription;
	DWORD		programid;
	DWORD		versionid;
	DWORD		reserved1;
	DWORD		maxplayers;
	LPVOID	initdata;
	DWORD		initdatabytes;
	LPVOID	reserved2;
	DWORD		optcategorybits;
} SNETPROGRAMDATA, *SNETPROGRAMDATAPTR;

Members

size
The size of the structure, in bytes.

programname
The name of the program.

programdescription
The description of the program.  This usually includes a name and version number.  It is displayed at the bottom of the standard connection screens.  If this field is not provided, Storm will automatically generate it using the EXE file’s product version information.

programid
A unique 32-bit identifier for the application.  The use of this unique identifier allows multiple applications using Storm to create games on the same network without interfering with each other.

versionid
A unique 32-bit identifier for the network version of the application.  This number should be incremented whenever a change in the application makes it incompatible with older versions.

reserved1
Reserved -- must be set to 0.

maxplayers
The maximum number of players per game supported by the application.

initdata
Application-specific initialization data.  This data is provided by the game creator, and is available to all joining computers through the SNET_EVENT_INITDATA callback.

initdatabytes
The size of the application-specific initialization data.

reserved2
Reserved – must be set to 0.

optcategorybits
This value provides a hint to the network provider about which category bits will most often be used by users to narrow the list of joinable games.  The network provider can use this hint to structure the way it stores its list of games.