Guide.ShowGameInvite Method (String)

Displays the game invitation user interface, taking a session ID.

Syntax

'Declaration
Public Shared Sub ShowGameInvite ( _
         sessionId As String _
)

public static void ShowGameInvite (
         string sessionId
)

public:
static void ShowGameInvite(
         String sessionId
)

Parameters

• sessionId
  Type: String
  The session ID to use for the game invitation.

Remarks

You can check GamerPrivileges.AllowCommunication to determine if a player is allowed to send and receive communications before displaying a menu option that would call this method.

Windows Phone Specific Information

No response to this method is returned. The player can choose invitation recipients from his or her own contact list on the phone. For each recipient chosen, an email is sent to the contact's email address. If the recipient has an Xbox LIVE Gamertag associated with this email address and a Windows Phone, an invitation is sent directly to the recipient's phone. If the recipient does not have an Xbox LIVE Gamertag associated with the email address or does not have a Windows Phone, the recipient only receives an email invitation. The email invitation will contain a link to play the game. This link uses a redirect service so that when the link is clicked an appropriate action is taken based on the platform the recipient is using. On a PC, the link opens a web-based version of the game, if one exists. On Windows Phone, the link will either open the game if it is already installed on the recipient's phone, or will open the Windows Phone Marketplace if the game is not installed.

Requirements

Namespace: Microsoft.Xna.Framework.GamerServices

Assembly: Microsoft.Xna.Framework.GamerServices (in microsoft.xna.framework.gamerservices.dll)

See Also

Reference

GamerPrivileges.AllowCommunication Property
Guide Class
Guide Members
Microsoft.Xna.Framework.GamerServices Namespace

Platforms

Windows Phone