IRTCClient2::PreferredSecurityLevel (Windows CE 5.0)
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