nn::nex::MatchMakingClient::FindByOwner Member Function

Syntax

qBool FindByOwner(
     ProtocolCallContext * pContext,
     PrincipalID pidOwner,
     const ResultRange & resultRange,
     qList< GatheringHolder > * plstGatherings
);

Parameters

Name Description
in pContext Call information.
in pidOwner PrincipalID to be used as a search key.
in resultRange Search range.
out plstGatherings The found gathering.

Return Values



Value Description
true Call initialization succeeded.
false Failure.

Description

Searches using the PrincipalId of the owner of the gathering.

This function searches for the gathering whose owner is the user having the specified PrincipalId.

The following results may be returned as a result of asynchronous operation. Use the application to handle these results.

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.

Revision History

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.
2011/04/20
Changed the function so that asynchronous processing returns an error if 101 or more entries are specified for the maximum size obtained by the ResultRange provided in the arguments.
2011/01/27
Initial version.

CONFIDENTIAL