IServerClient::SendMessage method

---

Sends an instant message to a user or on a messaging group.

HRESULT SendMessage(
    LPDWORD lpTransferMessageStruct,
    LPDWORD lpdwExtendedCode
);

Parameters

lpTransferMessageStruct

[in] Pointer to a TRANSFER_MESSAGE_STRUCT structure that contains information on the instant message.

lpdwExtendedCode

[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

S_OK

The function was successful. Check lpdwExtendedCode variable to get extended information.

E_INVALIDARG

One or more arguments are incorrect.

E_FAIL

Some error occurred in the function. Check lpdwExtendedCode variable to get extended information on the error.

Remarks

The lpszMessageKey member of the pointed TRANSFER_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.