IRTCClient2::AnswerMode

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This method sets or gets the answer mode for a session type.

The method determines if an incoming call is automatically answered, automatically rejected, or has the answering mode decided by the application upon notification.

Syntax

HRESULT put_AnswerMode( 
  RTC_SESSION_TYPE enType, 
  RTC_ANSWER_MODE enMode 
);
HRESULT get_AnswerMode( 
  RTC_SESSION_TYPE enType, 
  RTC_ANSWER_MODE* penMode 
);

Parameters

• enType
  [in] An RTC_SESSION_TYPE enumeration value specifying the session type.

• enMode, penMode
  [in, out] An RTC_ANSWER_MODE enumeration value specifying the answer mode.

Return Value

This method can return an RTC_E_ constant.

The following table shows additional return values.

Value	Meaning
E_INVALIDARG	When setting the answer mode, the enumeration value is not valid.
E_POINTER	The penMode parameter is not a valid pointer.
RTC_E_NOT_ALLOWED	The IRTCClient::ListenForIncomingSessions method has been called.

Remarks

Applications can call the get_AnswerMode method before calling the put_AnswerMode method to determine the default answer mode for a particular session type.

The put_AnswerMode method should be called after setting the allowed ports using IRTCClient2::AllowedPorts.

If put_AnswerMode is called after the listen mode has been set or retrieved using IRTCClient::ListenForIncomingSessions, the RTC Client API returns an RTC_E_NOT_ALLOWED error.

Requirements

Header	rtccore.h, rtccore.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

IRTCClient2
IRTCClient::ListenForIncomingSessions
RTC_ANSWER_MODE
RTC_SESSION_TYPE