Share via

IRTCClient2::PreferredSecurityLevel

  • Article

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 security level for each media type that is required for the session.

The put_PreferredSecurityLevel method is called once for each security level.

Syntax

HRESULT put_PreferredSecurityLevel(
  RTC_SECURITY_TYPE enSecurityType,
  RTC_SECURITY_LEVEL enSecurityLevel
);
HRESULT get_PreferredSecurityLevel(
  RTC_SECURITY_TYPE enSecurityType,
  RTC_SECURITY_LEVEL* penSecurityLevel
);

Parameters

  • enSecurityType
    [in] An RTC_SECURITY_TYPE enumeration value specifying the type of security.
  • enSecurityLevel, penSecurityLevel
    [in, out] An RTC_SECURITY_LEVEL enumeration value specifying the level of security that is supported.

Return Value

This method can return an RTC_E_ constant.

The following table shows additional possible return values.

Value Meaning

E_INVALIDARG

The enSecurityType or enSecurityLevel enumeration value is invalid.

E_POINTER

When retrieving the security level, the penSecurityLevel parameter is not a valid pointer.

Remarks

The security levels specified in this method apply to all future sessions created on the Client object.

The application can override settings on a per-session basis by calling IRTCSession2::PreferredSecurityLevel.

Aa924800.security(en-us,MSDN.10).gifSecurity Note:
The encryption key is sent over the SIP signaling channel. This key can be acquired by an attacker if the SIP signaling channel is not encrypted. The signaling channel can be encrypted by using the TLS transport.

Requirements

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

See Also

Reference

IRTCClient2
IRTCSession2::PreferredSecurityLevel
RTC_SECURITY_LEVEL
RTC_SECURITY_TYPE