IRTCClient2::get_PreferredSecurityLevel

  • Article

The get_PreferredSecurityLevel method retrieves the security levels required for the session. This method retrieves the security level that was set by IRTCClient2::put_PreferredSecurityLevel.

HRESULT get_PreferredSecurityLevel(RTC_SECURITY_TYPEenSecurityType,
RTC_SECURITY_LEVEL*penSecurityLevel);

Parameters

  • enSecurityType
    [in] An RTC_SECURITY_TYPE enumeration specifying the security types that the security levels will be applied to.
  • penSecurityLevel
    [out] Pointer to an RTC_SECURITY_LEVEL enumeration specifying the level of security that is supported.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_CLIENT_NOT_INITIALIZED The client object has not been initialized.
RTC_E_MEDIA_DISABLED The media manager has been disabled.
E_INVALIDARG The enumeration value is not valid.
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_IRTCClient2 is defined as 0C91D71D-1064-42da-BFA5-572BEB8EEA84.

See Also

IRTCClient2, RTC_SECURITY_LEVEL, RTC_SECURITY_TYPE, Retrieve the Security Level for the Client Object