$#K SNETUIDATA

The SNETUIDATA structure contains information which Storm and the network providers use to display user interface on behalf of the application program.

typedef struct _SNETUIDATA {
	DWORD				size;
	DWORD				uiflags;
	HWND				parentwindow;
	SNETGETARTPROC		artcallback;
	SNETCHECKAUTHPROC	authcallback;
	SNETCREATEPROC		createcallback;
	SNETDRAWDESCPROC	drawdesccallback;
	SNETSELECTEDPROC	selectedcallback;
	SNETMESSAGEBOXPROC	messageboxcallback;
	SNETPLAYSOUNDPROC	soundcallback;
	SNETSTATUSPROC		statuscallback;
	SNETGETDATAPROC		getdatacallback;
	SNETCATEGORYPROC		categorycallback;
} SNETUIDATA, *SNETUIDATAPTR;

Members

size
The size of the structure, in bytes.

uiflags
A set of flags specifying the desired behavior of the network provider’s user interface.  No flags are currently defined.

parentwindow
The window handle of the active window.  If Storm or a network provider creates a dialog box, it will use this handle for the parent window.

artcallback
A pointer to a function which Storm or a network provider can call to obtain artwork for the dialog background or controls.

authcallback
A pointer to a function which the network provider calls to determine whether the local player has access to a chat room.  This only applies to network providers which provide chat functionality.

createcallback
A pointer to a function which the network provider calls when the user has decided to create a game.  This function is responsible for asking the user for the game name and options, and then calling SNetCreateGame().

drawdesccallback
A pointer to a function which the network provider calls if it needs to draw a game or player description.  This allows the application to perform its own drawing.  For example, it could convert a cryptic description string which only the application understands, like “FOG LOW BATTLE.PUD” into a group of icons which would represent the game options in a way players could easily understand.

selectedcallback
A pointer to a function which Storm calls when the user selects a network provider.  This provides the application a chance to review the network provider’s ID and capabilities, and either accept the selection or present the user with an error message and reject the selection. 

messageboxcallback
A pointer to a function which Storm and the network provider can use to display message boxes.

soundcallback
A pointer to a function which Storm and the network provider can use to play sound effects.

statuscallback
A pointer to a function that the network provider can use to provide feedback on the status of a long operation.

getdatacallback
A pointer to a function that the network provider can use to request provider-specific data from the application.

categorycallback
A pointer to a function that the network provider can use to request information about which categories of games the user is interested in joining.