nn::nex::MatchmakeExtensionClient::AutoMatchmake Member Function

Syntax

qBool AutoMatchmake(
     ProtocolCallContext * pContext,
     const AutoMatchmakeParam & autoMatchmakeParam,
     MatchmakeSession * joinedMatchmakingSession
);

Parameters

Name Description
in pContext Call information.
in autoMatchmakeParam Parameters related to automatic matchmaking.
out joinedMatchmakingSession The joined matchmaking session.

Return Values



Value Description
true Call initialization succeeded.
false Failure.

Description

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.
You can choose to either handle the following error in the application or pass it to the error/EULA applet.

QERROR(RendezVous, GameServerMaintenance): This error occurs when the function is called between the GameServerMaintenance notification event and when game server maintenance takes place.

Revision History

2014/05/07
Corrected QERROR(Core, InvalidArgment) to QERROR(Core, InvalidArgument) in the description. Changed "community" to "persistent gathering."
2014/03/13
Initial version.

CONFIDENTIAL