qBool AutoMatchmake( ProtocolCallContext * pContext, const AutoMatchmakeParam & autoMatchmakeParam, MatchmakeSession * joinedMatchmakingSession );
Name | Description | |
---|---|---|
in | pContext | Call information. |
in | autoMatchmakeParam | Parameters related to automatic matchmaking. |
out | joinedMatchmakingSession | The joined matchmaking session. |
Value | Description |
---|---|
true | Call initialization succeeded. |
false | Failure. |
Automatically searches for and joins matchmaking sessions.
A search is made for a matchmaking session (gathering) based on the specified content in AutoMatchmakeParam
. If a search match is found, that session is joined. If a matching session is not found, a matchmaking session is created, and the station joins that session and the local user becomes the host.
This is the only overload of the MatchmakeExtensionClient::AutoMatchmake
function that can add multiple users to a matchmaking session.
The following results may be returned as a result of asynchronous operation. Use the application to handle these results.
QERROR(RendezVous, NotParticipatedGathering)
: The user that the function attempted to add is not a participant of the gathering specified by the AutoMatchmakeParam::SetGatheringIdForParticipationCheck
function.
Pass the following error to the Error/EULA applet. This error must be removed during debugging.
QERROR(Core, InvalidArgument)
: The string or buffer that was to be sent is too large. MATCHMAKE_SYSTEM_TYPE_PERSISTENT_GATHERING
or MATCHMAKE_SYSTEM_TYPE_OLV_COMMUNITY
was specified for the matchmaking system type, but the gathering ID of the persistent gathering was not set as the 0th attribute or as a related persistent gathering ID.QERROR(RendezVous, OutOfRatingRange)
: When MATCHMAKE_SELECTION_METHOD_BROADEN_RANGE
or MATCHMAKE_SELECTION_METHOD_BROADEN_RANGE_WITH_PROGRESS_SCORE
is set with the MatchmakeSessionSearchCriteria::SetSelectionMethod
function, the attribute of the MATCHMAKE_SESSION_BROADEN_RANGE_ATTRIBUTE_INDEX
index is out of range.
QERROR(RendezVous, GameServerMaintenance)
: This error occurs when the function is called between the GameServerMaintenance
notification event and when game server maintenance takes place.
QERROR(Core, InvalidArgment)
to QERROR(Core, InvalidArgument)
in the description.
Changed "community" to "persistent gathering."CONFIDENTIAL