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 member identifies the property and its dwPropertyData member contains the property information. To extract this information, cast the dwPropertyData member to the appropriate value. For example, the following routine retrieves the DPLDATA_PLAYERGUID structure from the given message. (See DPLPROPERTY_PlayerGuid.)

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