nn::nex::MatchmakeExtensionClient::BrowseMatchmakeSession Member Function

Syntax

qBool BrowseMatchmakeSession(
     ProtocolCallContext * pContext,
     const MatchmakeSessionSearchCriteria & searchCriteria,
     const ResultRange & resultRange,
     qList< GatheringHolder > * lstGathering
);

qBool BrowseMatchmakeSession(
     ProtocolCallContext * pContext,
     const MatchmakeSessionSearchCriteria & searchCriteria,
     const ResultRange & resultRange,
     qList< GatheringHolder > * lstGathering,
     qList< GatheringURLs > * lstGatheringURLs
);

qBool BrowseMatchmakeSession(
     ProtocolCallContext * pContext,
     const MatchmakeSessionSearchCriteria & searchCriteria,
     const ResultRange & resultRange,
     qList< MatchmakeSession > * lstMatchmakeSession
);

qBool BrowseMatchmakeSession(
     ProtocolCallContext * pContext,
     const MatchmakeSessionSearchCriteria & searchCriteria,
     const ResultRange & resultRange,
     qList< MatchmakeSession > * lstMatchmakeSession,
     qList< GatheringURLs > * lstGatheringURLs
);

Overloaded Member Functions

BrowseMatchmakeSession ( ProtocolCallContext *, const MatchmakeSessionSearchCriteria &, const ResultRange &, qList< GatheringHolder > * ) Searches for a matchmaking session.
BrowseMatchmakeSession ( ProtocolCallContext *, const MatchmakeSessionSearchCriteria &, const ResultRange &, qList< GatheringHolder > *, qList< GatheringURLs > * ) Searches for a matchmaking session.
BrowseMatchmakeSession ( ProtocolCallContext *, const MatchmakeSessionSearchCriteria &, const ResultRange &, qList< MatchmakeSession > * ) Searches for a matchmaking session.
BrowseMatchmakeSession ( ProtocolCallContext *, const MatchmakeSessionSearchCriteria &, const ResultRange &, qList< MatchmakeSession > *, qList< GatheringURLs > * ) Searches for a matchmaking session.

Description of BrowseMatchmakeSession ( ProtocolCallContext *, const MatchmakeSessionSearchCriteria &, const ResultRange &, qList< GatheringHolder > * )

We recommend using the overload in the MatchmakeSession class that gets the results. Searches for a matchmaking session by using the specified conditions.

The asynchronous process might return the following results.

Pass the following error to the Error/EULA applet. Errors must be removed during debugging.

QERROR(Core, InvalidArgument): 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. The maximum number of entries to get in the ResultRange object passed as an argument was set to more than 100.

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.

Description of BrowseMatchmakeSession ( ProtocolCallContext *, const MatchmakeSessionSearchCriteria &, const ResultRange &, qList< GatheringHolder > *, qList< GatheringURLs > * )

We recommend using the overload in the MatchmakeSession class that gets the results. Searches for matchmaking sessions with the specified conditions, and also gets the URLs of the hosts of the matchmaking sessions. Matchmaking sessions that do not have a host are excluded from the sessions searched.

The asynchronous process might return the following results.

Pass the following error to the Error/EULA applet. Errors must be removed during debugging.

QERROR(Core, InvalidArgument): 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. The maximum number of entries to get in the ResultRange object passed as an argument was set to more than 100.

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.

Description of BrowseMatchmakeSession ( ProtocolCallContext *, const MatchmakeSessionSearchCriteria &, const ResultRange &, qList< MatchmakeSession > * )

Searches for a matchmaking session by using the specified conditions.

The asynchronous process might return the following results.

Pass the following error to the Error/EULA applet. This error must be removed during debugging.

QERROR(Core, InvalidArgument): No gathering ID was set on the persistent gathering during persistent gathering matchmaking. The maximum number of entries to get in the ResultRange object passed as an argument was set to more than 100.

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.

Description of BrowseMatchmakeSession ( ProtocolCallContext *, const MatchmakeSessionSearchCriteria &, const ResultRange &, qList< MatchmakeSession > *, qList< GatheringURLs > * )

Searches for matchmaking sessions with the specified conditions, and also gets the URLs of the hosts of the matchmaking sessions. Matchmaking sessions that do not have a host are excluded from the sessions searched.

The asynchronous process might return the following results.

Pass the following error to the Error/EULA applet. Errors must be removed during debugging.

QERROR(Core, InvalidArgument): No gathering ID was set on the persistent gathering during persistent gathering matchmaking. The maximum number of entries to get in the ResultRange object passed as an argument was set to more than 100.

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.


CONFIDENTIAL