Share via

NetworkSession.Find Method (NetworkSessionType, Int32, NetworkSessionProperties)

  • Article

Issues a matchmaking query, searching for available multiplayer sessions. This method blocks until the operation has completed.

Namespace: Microsoft.Xna.Framework.Net
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

Syntax

public static AvailableNetworkSessionCollection Find (
         NetworkSessionType sessionType,
         int maxLocalGamers,
         NetworkSessionProperties searchProperties
)

Parameters

  • sessionType
    Type of session sought.
  • maxLocalGamers
    Maximum number of local players on the same gaming machine in this network session.
  • searchProperties
    Optional session properties to match during the search. If this argument is null, the query results will not be filtered based on the session properties of available sessions. If any of the search property values in searchProperties are specified, only sessions with matching properties will be returned by the query. null items in the searchProperties collection will match to any value for that session property.

Return Value

Collection of available network multiplayer sessions.

Exceptions

Exception type Condition
ArgumentException Find cannot be used from NetworkSession objects of session type NetworkSessionType.Local.
ArgumentOutOfRangeException maxLocalGamers must be between 1 and 4.

See Also

Tasks

How To: Find and Join a Network Session

Reference

NetworkSession Class
NetworkSession Members
Microsoft.Xna.Framework.Net Namespace

Platforms

Xbox 360, Windows XP SP2, Windows Vista, Zune