IRTCSession::EncryptionKey

  • Article

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 will not be encrypted.

Return Values

This method can return an RTC_E_ constant. The following table shows the possible return values.

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.

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

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.