Share via

IMsgrSession::Decline Method

  • Article

Deprecated. Recipient declines the invitation.

Syntax

HRESULT Decline(      
    BSTR bstrAppData
);

Parameters

  • bstrAppData
    [in] BSTR that specifies the application data. bstrAppData has a limit of 512 bytes.

Return Value

Returns one of the following values:

S_OK The invitation was declined successfully.
SR_NOT_INVITEE The invitation was sent to the wrong user.
E_INVALIDARG The value passed to the method was not valid.
SR_SESSION_STATE_INVALID The session state of the invited user is not valid.

Remarks

The recipient can decline the invitation by setting bstrAppData to NULL within the application.

The parameter defined in this method is passed to the recipient's session in the form of a notification from the DMsgrSessionEvents::OnDeclined event.

Important  IMsgrSession::Decline is no longer available in Windows Vista. See Windows Messenger for more information.

See Also

IMsgrSession::Accept, IMsgrSession::Cancel, IMsgrSession::Invite, DMsgrSessionEvents::OnDeclined, Messenger Session Invite and Messenger Private APIs, Messenger Lock and Key API