nn::nex::MatchmakeExtensionClient::FindPersistentGatheringByParticipant Member Function

Syntax

qBool FindPersistentGatheringByParticipant(
     ProtocolCallContext * pContext,
     PrincipalID principalId,
     const ResultRange & resultRange,
     qList< PersistentGathering > * pPersistentGatheringList
);

Parameters

Name Description
in pContext Call information.
in principalId The PrincipalId of the participant.
in resultRange Search range.
out pPersistentGatheringList List of persistent gatherings found in the search.

Return Values



Value Description
true Call initialization succeeded.
false Failure.

Description

Searches persistent gatherings using the PrincipalId of a participant.

Gets a list of the persistent gatherings to which the user with the specified PrincipalID is participating.

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 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.
This search can also get the participation status of non-friends in persistent gatherings, but such users will not be included in the search results in the following cases:

If a user that is subject to the search has used the UpdatePrivacySetting function to make their participation in the persistent gathering private.
If a user that is subject to the search has the local system registered to the blacklist.

Revision History

2014/04/08
Corrected QERROR(Core, InvalidArgment) to QERROR(Core, InvalidArgument) and QERROR(Core, GameServerMaintenance) to QERROR(RendezVous, GameServerMaintenance) in the description.
2013/11/28
Corrected the description so that QERROR(Core, InvalidArgment) is not handled by the application, but the error is passed to the error/EULA applet.
2013/05/31
Added a note indicating that QERROR(Core, GameServerMaintenance) is returned when the function is called between the GameServerMaintenance notification event and when game server maintenance takes place.
2013/01/11
Initial version.

CONFIDENTIAL