VoipCallCoordinator.RequestNewAppInitiatedCall Method

  • Reference

Definition

Namespace:
Windows.Phone.Networking.Voip

Overloads

RequestNewAppInitiatedCall(String, String, String, String, VoipCallMedia, IVector<String>, VoipPhoneCall)

Important

The types in the Windows.Phone.Networking.Voip namespace are deprecated, and may not be available in future versions of Windows. Instead, use the equivalent types in the Windows.ApplicationModel.Calls namespace.
RequestNewAppInitiatedCall(String, String, String, String, VoipCallMedia, VoipPhoneCall)

Important

The types in the Windows.Phone.Networking.Voip namespace are deprecated, and may not be available in future versions of Windows. Instead, use the equivalent types in the Windows.ApplicationModel.Calls namespace.

Makes a request to the system for a new call object.

RequestNewAppInitiatedCall(String, String, String, String, VoipCallMedia, IVector<String>, VoipPhoneCall)

Edit

Important

The types in the Windows.Phone.Networking.Voip namespace are deprecated, and may not be available in future versions of Windows. Instead, use the equivalent types in the Windows.ApplicationModel.Calls namespace.

public:
 virtual void RequestNewAppInitiatedCall(Platform::String ^ context, Platform::String ^ contactName, Platform::String ^ contactNumber, Platform::String ^ serviceName, VoipCallMedia media, IVector<Platform::String ^> ^ pAssociatedDeviceIds, [Out] VoipPhoneCall ^ & call) = RequestNewAppInitiatedCall;
void RequestNewAppInitiatedCall(winrt::hstring const& context, winrt::hstring const& contactName, winrt::hstring const& contactNumber, winrt::hstring const& serviceName, VoipCallMedia const& media, IVector<winrt::hstring> const& pAssociatedDeviceIds, [Out] VoipPhoneCall const& & call);
public void RequestNewAppInitiatedCall(string context, string contactName, string contactNumber, string serviceName, VoipCallMedia media, IList<string> pAssociatedDeviceIds, out VoipPhoneCall call);
Public Sub RequestNewAppInitiatedCall (context As String, contactName As String, contactNumber As String, serviceName As String, media As VoipCallMedia, pAssociatedDeviceIds As IList(Of String), ByRef call As VoipPhoneCall)

Parameters

context
String

Platform::String

winrt::hstring
contactName
String

Platform::String

winrt::hstring
contactNumber
String

Platform::String

winrt::hstring
serviceName
String

Platform::String

winrt::hstring
media
VoipCallMedia
pAssociatedDeviceIds

IList<String>

IVector<Platform::String>

IVector<winrt::hstring>
call
VoipPhoneCall

Applies to

RequestNewAppInitiatedCall(String, String, String, String, VoipCallMedia, VoipPhoneCall)

Edit

Important

The types in the Windows.Phone.Networking.Voip namespace are deprecated, and may not be available in future versions of Windows. Instead, use the equivalent types in the Windows.ApplicationModel.Calls namespace.

Makes a request to the system for a new call object.

public:
 virtual void RequestNewAppInitiatedCall(Platform::String ^ context, Platform::String ^ contactName, Platform::String ^ contactNumber, Platform::String ^ serviceName, VoipCallMedia media, [Out] VoipPhoneCall ^ & call) = RequestNewAppInitiatedCall;
void RequestNewAppInitiatedCall(winrt::hstring const& context, winrt::hstring const& contactName, winrt::hstring const& contactNumber, winrt::hstring const& serviceName, VoipCallMedia const& media, [Out] VoipPhoneCall const& & call);
public void RequestNewAppInitiatedCall(string context, string contactName, string contactNumber, string serviceName, VoipCallMedia media, out VoipPhoneCall call);
Public Sub RequestNewAppInitiatedCall (context As String, contactName As String, contactNumber As String, serviceName As String, media As VoipCallMedia, ByRef call As VoipPhoneCall)

Parameters

context
String

Platform::String

winrt::hstring

A string that is passed to the associated foreground app as a deep link. The maximum length is 128 characters. This parameter must be non-null.

contactName
String

Platform::String

winrt::hstring

The contact name of the caller to be displayed on the incoming call UI. The maximum length is 128 characters.

contactNumber
String

Platform::String

winrt::hstring

The phone number of the caller to be displayed on the incoming call UI. The maximum length is 128 characters.

serviceName
String

Platform::String

winrt::hstring

The name of the VoIP service or application. The maximum length is 128 characters.

media
VoipCallMedia

The media types used by the call (whether the call is audio/video rather than audio only).

call
VoipPhoneCall

The object representing the new initiated call.

Windows requirements

App capabilities
ID_CAP_VOIP [Windows Phone]

Remarks

Use this method to create a new VoipPhoneCall object, which can be used to set up a new in-app call notification and attach event handlers.

Your application should call VoipPhoneCall.NotifyCallAccepted if the user accepts the call. If the call is rejected or unanswered, use VoipPhoneCall.NotifyCallEnded. Alternatively, the system can raise the AnswerRequested or RejectRequested events on the VoipPhoneCall object to tell the VoIP app whether the user accepts or rejects the incoming call via a HID device.

Applies to