nn::nex::MatchMakingClient::UpdateGatheringOwnership Member Function

Syntax

qBool UpdateGatheringOwnership(
     ProtocolCallContext * pContext,
     GatheringID id
);

Parameters

Name Description
in pContext Call information.
in id The gathering ID whose owner is to be changed.

Return Values



Value Description
true Call initialization succeeded.
false Failure.

Description

Changes the gathering owner to the caller.

Changes the owner of the specified gathering to the caller. The GatheringFlags::ChangeOwnerByOtherHost flag must be set in the flags of the Gathering object. If the owner is changed successfully, NotificationEvents::OwnershipChangeEvent will be notified to all participants in the gathering. This function does not do anything useful if the user who calls it is already the owner.

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

QERROR(RendezVous, SessionVoid): Nonexistent gathering.
QERROR(RendezVous, PermissionDenied): Not participating in the gathering.
QERROR(RendezVous, InvalidOperation): Could not change owner because the GatheringFlags::ChangeOwnerByOtherHost flag is not set.

See Also

GatheringFlags

Revision History

2014/03/11
Initial version.

CONFIDENTIAL