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.