File: inviting.h

package info (click to toggle)
libquotient 0.9.5-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 5,588 kB
  • sloc: xml: 39,103; cpp: 25,226; sh: 97; makefile: 10
file content (39 lines) | stat: -rw-r--r-- 1,353 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
// THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN

#pragma once

#include <Quotient/jobs/basejob.h>

namespace Quotient {

//! \brief Invite a user to participate in a particular room.
//!
//! *Note that there are two forms of this API, which are documented separately.
//! This version of the API requires that the inviter knows the Matrix
//! identifier of the invitee. The other is documented in the
//! [third-party invites](/client-server-api/#third-party-invites) section.*
//!
//! This API invites a user to participate in a particular room.
//! They do not start participating in the room until they actually join the
//! room.
//!
//! Only users currently in a particular room can invite other users to
//! join that room.
//!
//! If the user was invited to the room, the homeserver will append a
//! `m.room.member` event to the room.
class QUOTIENT_API InviteUserJob : public BaseJob {
public:
    //! \param roomId
    //!   The room identifier (not alias) to which to invite the user.
    //!
    //! \param userId
    //!   The fully qualified user ID of the invitee.
    //!
    //! \param reason
    //!   Optional reason to be included as the `reason` on the subsequent
    //!   membership event.
    explicit InviteUserJob(const QString& roomId, const QString& userId, const QString& reason = {});
};

} // namespace Quotient