Give Us a Free Call: +1-877-99-BOPUP (877-992-6787)

IServerClient::SendMultipleMessage method

Sends an instant message to several users and/or messaging groups at the same time.

HRESULT SendMultipleMessage(     LPDWORD lpTranferMultipleMessageStruct,     LPDWORD lpMultipleRecipientsArray,     LPDWORD lpdwExtendedCode );


[in] Pointer to a TRANSFER_MULTIPLE_MESSAGE_STRUCT structure that contains information on the instant message.
[in] Pointer to an array of MULTIPLE_RECIPIENT_STRUCT structure that contains recipients of the message.
[out] Pointer to a DWORD variable that gets an extended code if error result is returned. For available codes see Available Extended Codes topic.

Return Value

The function was successful. Check lpdwExtendedCode variable to get extended information.
One or more arguments are incorrect.
Some error occurred in the function. Check lpdwExtendedCode variable to get extended information on the error.


The lpszMessageKey member of the pointed TRANSFER_MULTIPLE_MESSAGE_STRUCT contains a unique key if the call of the method is succeeded. That value can be used to identify the outgoing instant messaging in the application.
The nRecipientsCount member of the TRANSFER_MULTIPLE_MESSAGE_STRUCT structure pointed to by the lpTransferMultipleMessageStruct variable must contain the number of elements of the array pointed to by the lpMultipleRecipientsArray member.