IRTCSessionCallControl::put_ReferCookie

The put_ReferCookie method sets the application-defined cookie for the session. This method sets the cookie that is retrieved by the IRTCSessionReferredEvent::get_ReferCookie method.

HRESULT put_ReferCookie(BSTRbstrReferCookie);

Parameters

  • bstrReferCookie
    [in] BSTR that contains the application-defined cookie for the session. The cookie contains contextual information on the session that is being transferred. This cookie is entered by the party initiating the session transfer.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_E_INVALID_SESSION_STATE The session is not in the idle state.
E_OUTOFMEMORY Insufficient memory to perform this operation.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCSessionCallControl is defined as E9A50D94-190B-4F82-9530-3B8EBF60758A.

See Also

IRTCSessionCallControl, Session Control, Session Transfer Accepted