nn::nex::MatchmakeExtensionClient::UpdateMatchmakeSession Member Function

Syntax

qBool UpdateMatchmakeSession(
     ProtocolCallContext * pContext,
     const GatheringHolder & matchmakingSession
);

qBool UpdateMatchmakeSession(
     ProtocolCallContext * pContext,
     const UpdateMatchmakeSessionParam & updateMatchmakeSessionParam
);

Overloaded Member Functions

UpdateMatchmakeSession ( ProtocolCallContext *, const GatheringHolder & ) Updates a matchmaking session.
UpdateMatchmakeSession ( ProtocolCallContext *, const UpdateMatchmakeSessionParam & ) Updates a matchmaking session.

Description of UpdateMatchmakeSession ( ProtocolCallContext *, const GatheringHolder & )

We recommend using the overload that takes UpdateMatchmakeSessionParam as an argument. Updates all of the data, except for the matchmaking session ID, owner, P2P communication host, gathering flags, communication key for P2P session, and related persistent gathering ID. The matchmaking system type can only be changed between MATCHMAKE_SYSTEM_TYPE_ANYBODY and MATCHMAKE_SYSTEM_TYPE_FRIEND. Only the owner of the matchmaking session can do this. Before calling this function, you must specify the gathering ID for the matchmaking session to update. This parameter is specified with the Gathering::SetID function.

The following results may be returned as a result of asynchronous operation. Use the application to handle these results.

QERROR(RendezVous, SessionVoid): The matchmaking session does not exist.
QERROR(RendezVous, PermissionDenied): The caller is not the owner.

The following results may be returned as a result of asynchronous operation. Pass errors to the Error/EULA applet. This error must be removed during debugging.

QERROR(Core, InvalidArgument): The change made by UpdateMatchmakeSessionParam::SetMatchmakeSystemType was not between MATCHMAKE_SYSTEM_TYPE_ANYBODY and MATCHMAKE_SYSTEM_TYPE_FRIEND.

Description of UpdateMatchmakeSession ( ProtocolCallContext *, const UpdateMatchmakeSessionParam & )

Only updates the specified data. Only the owner of the matchmaking session can do this. Before calling this function, you must specify the gathering ID for the matchmaking session to update. This parameter is specified with the Gathering::SetID function.

The following results may be returned as a result of asynchronous operation. Use the application to handle these results.

QERROR(RendezVous, SessionVoid): The matchmaking session does not exist.
QERROR(RendezVous, PermissionDenied): The caller is not the owner.

The following results may be returned as a result of asynchronous operation. Pass errors to the Error/EULA applet. This error must be removed during debugging.

QERROR(Core, InvalidArgument): Both MATCHMAKE_SESSION_MODIFICATION_FLAG_MATCHMAKE_PARAM and MATCHMAKE_SESSION_MODIFICATION_FLAG_MATCHMAKE_PARAM_OVERRIDE have been specified in UpdateMatchmakeSessionParam::SetModificationFlag. The change made by UpdateMatchmakeSessionParam::SetMatchmakeSystemType was not between MATCHMAKE_SYSTEM_TYPE_ANYBODY and MATCHMAKE_SYSTEM_TYPE_FRIEND.


CONFIDENTIAL