qBool UpdateGatheringOwnership( ProtocolCallContext * pContext, GatheringID id );
Name | Description | |
---|---|---|
in | pContext | Call information. |
in | id | The gathering ID whose owner is to be changed. |
Value | Description |
---|---|
true | Call initialization succeeded. |
false | Failure. |
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.
CONFIDENTIAL