PhoneCallOriginManager.SetCallOrigin(Guid, PhoneCallOrigin) Метод

Определение

Задает источник звонка при выполнении телефонного звонка.

public:
 static void SetCallOrigin(Platform::Guid requestId, PhoneCallOrigin ^ callOrigin);
 static void SetCallOrigin(winrt::guid const& requestId, PhoneCallOrigin const& callOrigin);
/// [Windows.Foundation.Metadata.Deprecated("PhoneCallOriginManager is deprecated and might not work for all platforms. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 458752, "Windows.ApplicationModel.Calls.CallsPhoneContract")]
 static void SetCallOrigin(winrt::guid const& requestId, PhoneCallOrigin const& callOrigin);
public static void SetCallOrigin(Guid requestId, PhoneCallOrigin callOrigin);
[Windows.Foundation.Metadata.Deprecated("PhoneCallOriginManager is deprecated and might not work for all platforms. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 458752, "Windows.ApplicationModel.Calls.CallsPhoneContract")]
public static void SetCallOrigin(Guid requestId, PhoneCallOrigin callOrigin);
function setCallOrigin(requestId, callOrigin)
Public Shared Sub SetCallOrigin (requestId As Guid, callOrigin As PhoneCallOrigin)

Параметры

requestId
Guid

Platform::Guid

winrt::guid

Уникальный идентификатор для этого телефонного звонка. Он извлекается из targetIdобъекта PhoneCallOriginDataRequestTriggerDetails.

callOrigin
PhoneCallOrigin

Сведения о звонке для входящего звонка.

Атрибуты

Требования к Windows

Возможности приложения
phoneCallHistory phoneCallHistorySystem

Комментарии

Перед попыткой вызова этого метода убедитесь в следующем.

  • Вы объявляете возможность PhoneCall в файле манифеста приложения следующим образом: <uap:Capability Name="phoneCall" />
  • Приложение имеет фоновую задачу, которая привязывает триггер PhoneCallOriginDataRequestTriggerDetails .
  • Приложение может совершать телефонные звонки (в разделе Параметры —> Конфиденциальность —> Телефонные звонки).

Если какое-либо из этих значений не соответствует действительности, SetCallOrigin вернет ошибку об отказе в доступе.

Этот метод следует вызывать в фоновом режиме, когда приложение активируется phoneCallOriginDataRequestTriggerDetails.

В следующем примере показано, как задать расположение источника в ответ на триггер.

public sealed class CallOriginLookupBackgroundTask : IBackgroundTask
{
    public async void Run(IBackgroundTaskInstance taskInstance)
    {

        PhoneCallOriginDataRequestTriggerDetails callDetails =
               (PhoneCallOriginDataRequestTriggerDetails)taskInstance.TriggerDetails;

        var deferral = taskInstance.GetDeferral();
        //look up local data source for call's location and category
        PhoneCallOrigin data = LocalLookupForCallerData(callDetails.PhoneNumber);
        //set phone call origin
        PhoneCallOriginManager.SetCallOrigin(callDetails.targetId, data);

        deferral.Complete();
    }
}

Применяется к