TRANSFER_MESSAGE_STRUCT structure

Specifies or retrieves information on a single instant message.

typedef struct _TRANSFER_MESSAGE_STRUCT {     char lpszMessageKey[UNIQUE_KEY_LENGTH + 1];     BYTE iType;     DWORD dwMessageFlags;     char lpszSenderName[ACCOUNT_LENGTH + 1];     char lpszSenderFirstName[64 + 1];     char lpszSenderLastName[64 + 1];     char lpszRecipientName[ACCOUNT_LENGTH + 1];     char lpszTypeName[64 + 1];     BYTE lpszMessageText[MESSAGE_LENGTH + 1];     char lpszTextFont[32];     INT iTextSize;     DWORD dwTextStyle;     DWORD dwTextColor;     char lpszOriginalDate[32]; } TRANSFER_MESSAGE_STRUCT;

Members

lpszMessageKey
Contains a unique message key. This member is filled if IServerClient::SendMessage method returns a success result or when new incoming message is received via NOTIFY_NEW_MESSAGE notification that is sent in the form of WM_NOTIFY_SERVER message. This value can be used to identify each instant message in the application.
iType
Specifies a type of the instant message. This member can be one of the following values:
MESSAGE_TYPE_USER
This instant message is personal message.
MESSAGE_TYPE_GROUP
This instant message is a group message.
MESSAGE_TYPE_NEWS
This instant message is a new message. Messages with such type can be only incoming message from the IM server.
dwMessageFlags
Array of bitwise flags that specify parameters of the message. This member can be one or more of the following values:
MESSAGE_FLAG_URGENT
Indicates high priority (urgent) message.
MESSAGE_FLAG_OFFLINE
Indicates that the message has been forwarded the IM server and was stored as offline. This flag can be set only for incoming messages.
MESSAGE_FLAG_CONFIRMATION
Indicates that the message requires recipient's confirmation.
lpszSenderName
Contains the sender's account name. For outgoing messages this member must contain current user's account name.
lpszSenderFirstName
Contains the sender's first name. This member is valid only for incoming personal and group messages.
lpszSenderLastName
Contains the sender's last name. This member is valid only for incoming personal and group messages.
lpszRecipientName
Contains the recipient's account name. This member is valid only for personal messages.
lpszTypeName
Contains group or news name. This member is valid only for group and news messages.
lpszMessageText
Contains a text of the instant message.
lpszTextFont
Contains a font family to display the text message. Set this member to TEXT_FONT_FAMILY_DEFAULT to use default 'Arial'.
iTextSize
Contains a font size to display the text message. Set this member to TEXT_FONT_SIZE_DEFAULT to use default '-13' font size.
dwTextStyle
Contains a style of the message font. This member can be one or more of the following bitwise flags:
TEXT_FONT_STYLE_BOLD
Indicates bold font.
TEXT_FONT_STYLE_ITALIC
Indicates italic font.
dwTextColor
Contains a font color to display the text message. Set this member to TEXT_FONT_COLOR_DEFAULT to use default 'RGB(0, 0, 0)' font color.
lpszOriginalDate
Contains original date when the message was initially sent. The date is stored in the "MM/dd/YYYY 00:00:00" format where MM — month, dd — day and YYYY indicates year. This member is valid only for incoming messages when the dwMessageFlags has the MESSAGE_FLAG_OFFLINE flag.