qBool UpdateMatchmakeSession( ProtocolCallContext * pContext, const GatheringHolder & matchmakingSession );
Name | Description | |
---|---|---|
in | pContext | Call information. |
in | matchmakingSession | The matchmaking session to be updated. |
Value | Description |
---|---|
true | Call initialization succeeded. |
false | Failure. |
Updates a matchmaking session.
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
.
MATCHMAKE_SYSTEM_TYPE_ANYBODY
and MATCHMAKE_SYSTEM_TYPE_FRIEND
. Added that it is not possible to change the related persistent gathering ID.QERROR(RendezVous, PermissionDenied)
instead of success without doing anything when it is called by a station that is not the owner of the matchmaking session.MatchmakeSession
object provided in the arguments.
CONFIDENTIAL