IRTCClient2::PreferredSecurityLevel (Windows Embedded CE 6.0)

1/6/2010

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.

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.

Security 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

See Also

Reference

IRTCClient2
IRTCSession2::PreferredSecurityLevel
RTC_SECURITY_LEVEL
RTC_SECURITY_TYPE