IRTCClient2::PreferredSecurityLevel (Windows CE 5.0)

Send Feedback

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.

HRESULT put_PreferredSecurityLevel(RTC_SECURITY_TYPEenSecurityType,RTC_SECURITY_LEVELenSecurityLevel);HRESULT get_PreferredSecurityLevel(RTC_SECURITY_TYPEenSecurityType,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 Values

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.

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

OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.

See Also

IRTCClient2 | IRTCSession2::PreferredSecurityLevel | RTC_SECURITY_LEVEL | RTC_SECURITY_TYPE

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.