Share via


IRTCClient::LocalUserURI

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This method sets or gets the SIP Universal Resource Identifier (URI) used in the From: header of messages sent from the client.

Syntax

HRESULT put_LocalUserURI(
  BSTR bstrUserURI
);
HRESULT get_LocalUserURI(
  BSTR* pbstrUserURI
);

Parameters

  • bstrUserURI, pbstrUserURI
    [in, out] The user SIP URI.

    On output, this parameter is a pointer to a BSTR that is filled with the user SIP URI, 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

The get property can return an RTC_E_ constant.

The following table shows an additional possible return value.

Value Description

E_FAIL

No local user URI.

Remarks

The initial default value for the local user URI is the local machine name.

This method writes the new default value.

Use this URI only when a profile is not used for the session. For sessions that use a profile, the value is taken directly from the profile.

The default value is the machine name.

Requirements

Header rtccore.h, rtccore.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IRTCClient
IRTCClient::LocalUserName

Other Resources

SysFreeString