DWC_GetAIDList

C Specification

#include <dwc.h>

int DWC_GetAIDList(u8** aidList);

Description

This function gets the pointer to the connected host's AID list (does not copy).

AID uses a numerical value starting with 0 (number of devices making up the network -1) for the identification number of each DS within the mesh type network. For example, if four people have completed matchmaking, devices 0, 1, 2, and 3 will be present. If device 1 leaves the network, the remaining devices will be 0, 2, and 3.
For server-client matchmaking, the AID for the server DS will always be 0.

Use the DWC_GetAIDBitmap function to get the AID of the connected host as a bitmap.

Arguments

aidList The pointer to the AID list

Return Values

Returns the number of connected hosts, including this one. If this function is called when the FriendsMatch Library is not running, a 0 will be returned.

See Also

DWC_GetMyAID, DWC_GetAIDBitmap

Revision History

02/22/2006 Added description of AID during server-client matchmaking
01/31/2006 Devised the Return Values section with information on the FriendsMatch Library
12/16/2005 Added AID and return value descriptions
07/22/2005 Initial version