Share via


IRTCClient2::AnswerMode (Windows Embedded CE 6.0)

1/6/2010

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