DirectPlay Defined Properties

This section describes the defined properties that can be set and retrieved by applications from a lobby.

When a DPLMSG_GETPROPERTYRESPONSE message is received, its guidPropertyTag field identifies the property and its dwPropertyData field contains the property information. To extract this information, cast the dwPropertyData field to the appropriate value. For example, the following routine retrieves the DPLDATA_PLAYERGUID structure from the given message:

BOOL GetPlayerGuid(LPDPLMSG_GETPROPERTYRESPONSE  lpPropertyResponseMsg,
                       LPDPLDATA_PLAYERGUID lpPlayerGuid)
{
   if (IsEqualGUID(lpPropertyResponseMsg->guidPropertyTag, DPLPROPERTY_PlayerGuid))
   {
      *lpPlayerGuid = *((LPDPLDATA_PLAYERGUID) lpPropertyResponseMsg->dwPropertyData);
      return (TRUE);
   }
   else
   {
      return (FALSE);
   }  
}

See the following descriptions of defined properties.

• DPLPROPERTY_LobbyGuid
• DPLPROPERTY_MessagesSupported
• DPLPROPERTY_PlayerGuid
• DPLPROPERTY_PlayerScore

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.

Top of Page