IRTCSessionReferredEvent::ReferToURI
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method gets the URI of the party to whom the session is referred, that is, the transfer target. This information is used by the recipient to create a new session with the transfer target.
Syntax
HRESULT get_ReferToURI(
BSTR* pbstrReferToURI
);
Parameters
pbstrReferToURI
[out] Pointer to a BSTR that is filled with the URI of the transfer target, or an empty string if there is no entry.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 a specific return value.
| Value | Meaning |
|---|---|
E_POINTER |
The pbstrReferToURI parameter is not a valid pointer. |
E_OUTOFMEMORY |
Insufficient memory to perform this operation. |
RTC_E_NOT_EXIST |
The URI of the transfer target does not exist for this event. |
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |