IRTCSessionCallControl::ReferCookie (Windows Embedded CE 6.0)
1/6/2010
This method sets or gets the cookie for a transferred session. The cookie contains information about the session from the remote client that initiated the transfer.
Syntax
HRESULT put_ReferCookie(
BSTR bstrReferCookie
);
HRESULT get_ReferCookie(
BSTR* pbstrReferCookie
);
Parameters
bstrReferCookie, pbstrReferCookie
[in, out] The application-defined cookie for the session.The method allocates the buffer.
The caller is responsible for releasing this memory with SysFreeString.
Return Value
This method can return an RTC_E_ constant.
The following table shows additional return values and additional information about specific return values.
| Value | Meaning |
|---|---|
E_OUTOFMEMORY |
Insufficient memory to perform this operation. |
E_POINTER |
The pbstrReferCookie parameter is not a valid pointer. |
S_FALSE |
The session was not referred. The pbstrReferCookie parameter contains NULL. |
RTC_E_INVALID_SESSION_STATE |
When setting the cookie, the session is not in the idle state. When retrieving the cookie, the session is not in either the RTCSS_HOLD or RTCSS_CONNECTED state. |
RTC_E_NOT_EXIST |
The session was not referred and there is no refer cookie to return. |
Remarks
On input, the cookie should contain contextual information about the session that is being transferred. This cookie is entered by the party initiating the session transfer.
On output, if the session was referred, the pbstrReferCookie parameter returns the value set in the bstrReferCookie parameter of the IRTCSessionCallControl::Refer method. If the session was not redirected, the pbstrReferCookie parameter is NULL and the method returns S_FALSE.
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |
See Also
Reference
IRTCSessionCallControl
IRTCSessionCallControl::Refer