Status Property

Description of the availability of this entity.

Syntax

ANSI (Cross Platform)
char* GetStatus();
int SetStatus(const char* lpszStatus); Unicode (Windows) LPWSTR GetStatus();
INT SetStatus(LPCWSTR lpszStatus);
@property (nonatomic,readwrite,assign,getter=status,setter=setStatus:) NSString* status;
- (NSString*)status;
- (void)setStatus:(NSString*)newStatus;
#define PID_XMPP_STATUS 40

IPWORKSMQ_EXTERNAL void* IPWORKSMQ_CALL IPWorksMQ_XMPP_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
IPWORKSMQ_EXTERNAL int IPWORKSMQ_CALL IPWorksMQ_XMPP_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value

"Available for Chat."

Remarks

When the class completes the initial log in, it will send information telling other entities subscribed to this entity's presence that it is online. The application must provide different status and availability information as the user changes them.

The Presence property has one of four values representing general information about the user's status as defined in the Jabber protocol specification:

pcOffline (0)Invisible: JabberId is offline.
pcChat (1)Available: JabberId is online.
pcAway (2)Away: JabberId is online, but the user is away from their computer.
pcXA (3)Extended Away: JabberId is online, but the user is away from their computer for an extended period of time.
pcDND (4)Do not Disturb: JabberId is online, but is busy and does not wish to be disturbed.

By default, the class sets the client presence to pcChat, meaning that the user is available. To change the initial status sent by the class set Presence to the desired presence before calling Connect.

Note: offline is not officially supported by the XMPP specification, however some XMPP server implementations may recognize the value. Setting the client's presence state to this value may cause the server to respond with an Error.

The Status property is a pure-text string representing the user's presence information. Its value maybe be any random string, including the empty string, "".

Whenever the value in Presence or Status are changed, the class will send that information to the server. If the application or user wishes to associate a specific status message with a new presence value, it should use the ChangePresence method. ChangePresence will update both the Presence and Status properties, and then send that information to the server.

This property is not available at design time.

Data Type

String

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks MQ 2020 C++ Edition - Version 20.0 [Build 8155]