IRTCSession::EncryptionKey (Windows CE 5.0)
This method sets the encryption key to be used for one or more media streams.
HRESULT put_EncryptionKey(long lMediaType,BSTR EncryptionKey);
Parameters
lMediaType
[in] An RTCMT_ constant specifying the media type to which the encryption key applies.EncryptionKey
[in] A string following the SDP syntax for specifying session keys.If the string is set to NULL, the stream is not encrypted.
Return Values
This method can return an RTC_E_ constant.
The following table shows additional information about a specific return value.
| Value | Description |
|---|---|
| RTC_E_INVALID_SESSION_TYPE | The session must be of type PC-to-PC or PC-to-phone. |
Remarks
The application must call this method before answering incoming sessions, before adding participants to outgoing sessions, or before adding a stream to an existing session.
The application should call this method only to use an encryption key received by an out-of-band mechanism.
The application is responsible for exchanging the key with the remote endpoint.
The IRTCSession2::PreferredSecurityLevel method can be used to encrypt the media content of a PC-to-PC session. This method creates an encryption key internally and exchanges the encryption key with the remote endpoint through the SIP signaling channel.
Security Note The encryption key is temporarily cached in memory in clear text.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IRTCSession | IRTCSession2::PreferredSecurityLevel
Send Feedback on this topic to the authors