void SetSearchCriteria( const qList< MatchmakeSessionSearchCriteria > & searchCriteria );
Name | Description | |
---|---|---|
in | searchCriteria | Returns the search criteria for the matchmaking session. Up to two can be specified. |
Sets the search criteria for the matchmaking session.
A search is made for a matchmaking session (gathering) based on the specified search conditions. If a search match is found, that session is joined. Multiple search criteria can be passed as a list, and the criteria are applied in the order they are listed. Up to 50 matchmaking sessions are listed for the first search criteria, and the system attempts to join those sessions. If the system successfully joins, no additional searches are run. If no matchmaking sessions were found or the system was unable to join the ones that were found, another search is run with the next criteria. In other words, you can search for matchmaking sessions as you gradually ease your search conditions. If no session matches any of the search criteria, a matchmaking session is created using the parameters specified with the AutoMatchmakeParamSetSourceMatchmakeSession
function. Up to two search criteria can be specified. If three or more are specified, a QERROR(Core, InvalidArgument)
occurs. This function and AutoMatchmakeParam::SetTargetGatheringId
are mutually exclusive. You cannot set both. The initial state is empty.
InvalidArgument
.CONFIDENTIAL