author | Mikael Hallendal <micke@imendio.com> |
Sat, 24 Feb 2007 07:10:09 +0100 | |
changeset 237 | 7b9c442e7251 |
parent 140 | 103227122f45 |
child 285 | 7dee90bf5ee8 |
permissions | -rw-r--r-- |
1 | 1 |
<!-- ##### SECTION Title ##### --> |
2 |
LmMessage |
|
3 |
||
4 |
<!-- ##### SECTION Short_Description ##### --> |
|
5 |
A message is built up like a tree of message nodes. |
|
6 |
||
7 |
<!-- ##### SECTION Long_Description ##### --> |
|
8 |
<para> |
|
9 |
Represents a message that can be sent with lm_connection_send(), lm_connection_send_with_reply() or lm_connection_send_with_reply_and_block(). Either use lm_message_new() or lm_message_new_with_subtype() to create a message. You need to call lm_message_unref() when are finished with it. |
|
10 |
||
11 |
</para> |
|
12 |
||
13 |
<!-- ##### SECTION See_Also ##### --> |
|
14 |
<para> |
|
15 |
||
16 |
</para> |
|
17 |
||
140
103227122f45
2006-04-19 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents:
51
diff
changeset
|
18 |
<!-- ##### SECTION Stability_Level ##### --> |
103227122f45
2006-04-19 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents:
51
diff
changeset
|
19 |
|
103227122f45
2006-04-19 Mikael Hallendal <micke@imendio.com>
hallski <hallski>
parents:
51
diff
changeset
|
20 |
|
51 | 21 |
<!-- ##### STRUCT LmMessage ##### --> |
1 | 22 |
<para> |
23 |
Struct |
|
24 |
</para> |
|
25 |
||
51 | 26 |
@node: |
27 |
@priv: |
|
1 | 28 |
|
29 |
<!-- ##### ENUM LmMessageType ##### --> |
|
30 |
<para> |
|
31 |
Describes what type of message a message is. This maps directly to top level elements in the jabber protocol. |
|
32 |
</para> |
|
33 |
||
34 |
@LM_MESSAGE_TYPE_MESSAGE: a message, <message/> |
|
35 |
@LM_MESSAGE_TYPE_PRESENCE: a presence element, <presence/> |
|
36 |
@LM_MESSAGE_TYPE_IQ: an info/query element, <iq/> |
|
37 |
@LM_MESSAGE_TYPE_STREAM: the stream:stream element, you probably don't need to create a message of this type. |
|
237
7b9c442e7251
Some tweaks while trying to solve LM-52.
Mikael Hallendal <micke@imendio.com>
parents:
140
diff
changeset
|
38 |
@LM_MESSAGE_TYPE_STREAM_FEATURES: |
7b9c442e7251
Some tweaks while trying to solve LM-52.
Mikael Hallendal <micke@imendio.com>
parents:
140
diff
changeset
|
39 |
@LM_MESSAGE_TYPE_AUTH: |
7b9c442e7251
Some tweaks while trying to solve LM-52.
Mikael Hallendal <micke@imendio.com>
parents:
140
diff
changeset
|
40 |
@LM_MESSAGE_TYPE_CHALLENGE: |
7b9c442e7251
Some tweaks while trying to solve LM-52.
Mikael Hallendal <micke@imendio.com>
parents:
140
diff
changeset
|
41 |
@LM_MESSAGE_TYPE_RESPONSE: |
7b9c442e7251
Some tweaks while trying to solve LM-52.
Mikael Hallendal <micke@imendio.com>
parents:
140
diff
changeset
|
42 |
@LM_MESSAGE_TYPE_SUCCESS: |
7b9c442e7251
Some tweaks while trying to solve LM-52.
Mikael Hallendal <micke@imendio.com>
parents:
140
diff
changeset
|
43 |
@LM_MESSAGE_TYPE_FAILURE: |
1 | 44 |
@LM_MESSAGE_TYPE_STREAM_ERROR: a stream:error element |
45 |
@LM_MESSAGE_TYPE_UNKNOWN: incoming message is of some unknown type. |
|
46 |
||
47 |
<!-- ##### ENUM LmMessageSubType ##### --> |
|
48 |
<para> |
|
49 |
Describes the sub type of a message. This is equal to the "type" attribute in the jabber protocol. What sub type a message can have is depending on the type of the message. |
|
50 |
</para> |
|
51 |
||
52 |
@LM_MESSAGE_SUB_TYPE_NOT_SET: the default. No "type" attribute will be sent. |
|
51 | 53 |
@LM_MESSAGE_SUB_TYPE_AVAILABLE: presence is available, applies to message type "presence" |
1 | 54 |
@LM_MESSAGE_SUB_TYPE_NORMAL: |
55 |
@LM_MESSAGE_SUB_TYPE_CHAT: message is a chat message, applies to message type "message" |
|
56 |
@LM_MESSAGE_SUB_TYPE_GROUPCHAT: message is a group chat message, applies to message type "message" |
|
57 |
@LM_MESSAGE_SUB_TYPE_HEADLINE: message is a headline message, applies to message type "message" |
|
58 |
@LM_MESSAGE_SUB_TYPE_UNAVAILABLE: presence is unavailable, applies to message type "presence" |
|
59 |
@LM_MESSAGE_SUB_TYPE_PROBE: a probe presence, applies to message type "presence" |
|
60 |
@LM_MESSAGE_SUB_TYPE_SUBSCRIBE: try to subscribe to another jids presence, applies to message type "presence" |
|
61 |
@LM_MESSAGE_SUB_TYPE_UNSUBSCRIBE: unsubscribes from another jids presence, applies to message type "presence" |
|
62 |
@LM_MESSAGE_SUB_TYPE_SUBSCRIBED: reply from a subscribe message, informs that the subscription was successful. Applies to message type "presence" |
|
63 |
@LM_MESSAGE_SUB_TYPE_UNSUBSCRIBED: reply from subscribe or unsubscribe message. If it's a reply from a subscribe message it notifies that the subscription failed. Applies to message type "presence" |
|
64 |
@LM_MESSAGE_SUB_TYPE_GET: used to get information from an IQ query, applies to message type "iq" |
|
65 |
@LM_MESSAGE_SUB_TYPE_SET: used to set information in a IQ call, applised to message type "iq" |
|
66 |
@LM_MESSAGE_SUB_TYPE_RESULT: message is an IQ reply, applies to message type "iq" |
|
67 |
@LM_MESSAGE_SUB_TYPE_ERROR: messages is an error, applies to all message types. |
|
68 |
||
69 |
<!-- ##### FUNCTION lm_message_new ##### --> |
|
70 |
<para> |
|
71 |
||
72 |
</para> |
|
73 |
||
74 |
@to: |
|
75 |
@type: |
|
76 |
@Returns: |
|
77 |
||
78 |
||
79 |
<!-- ##### FUNCTION lm_message_new_with_sub_type ##### --> |
|
80 |
<para> |
|
81 |
||
82 |
</para> |
|
83 |
||
84 |
@to: |
|
85 |
@type: |
|
86 |
@sub_type: |
|
87 |
@Returns: |
|
88 |
||
89 |
||
90 |
<!-- ##### FUNCTION lm_message_get_type ##### --> |
|
91 |
<para> |
|
92 |
||
93 |
</para> |
|
94 |
||
95 |
@message: |
|
96 |
@Returns: |
|
97 |
||
98 |
||
99 |
<!-- ##### FUNCTION lm_message_get_sub_type ##### --> |
|
100 |
<para> |
|
101 |
||
102 |
</para> |
|
103 |
||
104 |
@message: |
|
105 |
@Returns: |
|
106 |
||
107 |
||
108 |
<!-- ##### FUNCTION lm_message_get_node ##### --> |
|
109 |
<para> |
|
110 |
||
111 |
</para> |
|
112 |
||
113 |
@message: |
|
114 |
@Returns: |
|
115 |
||
116 |
||
117 |
<!-- ##### FUNCTION lm_message_ref ##### --> |
|
118 |
<para> |
|
119 |
||
120 |
</para> |
|
121 |
||
122 |
@message: |
|
123 |
@Returns: |
|
124 |
||
125 |
||
126 |
<!-- ##### FUNCTION lm_message_unref ##### --> |
|
127 |
<para> |
|
128 |
||
129 |
</para> |
|
130 |
||
131 |
@message: |
|
132 |
||
133 |