IRTCSession2::get_PreferredSecurityLevel

  • Article

The get_PreferredSecurityLevel method returns the security level for the specified media type for the session. This method returns the security level set in IRTCSession2::put_PreferredSecurityLevel.

HRESULT get_PreferredSecurityLevel(RTC_SECURITY_TYPEenSecurityType,
RTC_SECURITY_LEVEL*penSecurityLevel);

Parameters

  • enSecurityType
    [in] An RTC_SECURITY_TYPE enumeration specifying the media type.
  • penSecurityLevel
    [out] Pointer to an RTC_SECURITY_LEVEL enumeration containing the security level for the specified media type.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_E_INVALID_SESSION_TYPE The session type is not PC-PC or the media is not enabled.
E_INVALIDARG The enumeration valus is not within the valid range.
E_POINTER The penSecurityLevel parameter is not a valid pointer.

Remarks

Encryption for data collaboration (RTCMT_T120_SENDRECV) sessions requires Windows XP SP1 or greater.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCSession2 is defined as 17D7CDFC-B007-484c-99D2-86A8A820991D.

See Also

IRTCSession2, RTC_SECURITY_LEVEL, RTC_SECURITY_TYPE