Compartilhar via


PhoneCallOriginManager.SetCallOrigin(Guid, PhoneCallOrigin) Método

Definição

Define a origem da chamada quando uma chamada telefônica entra.

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)

Parâmetros

requestId
Guid

Platform::Guid

winrt::guid

O identificador exclusivo para essa chamada telefônica. Isso é recuperado do targetId do PhoneCallOriginDataRequestTriggerDetails

callOrigin
PhoneCallOrigin

As informações de chamada para a chamada de entrada.

Atributos

Requisitos do Windows

Funcionalidades do aplicativo
phoneCallHistory phoneCallHistorySystem

Comentários

Antes de tentar chamar esse método, verifique o seguinte.

  • Você declara a funcionalidade PhoneCall no arquivo de manifesto do aplicativo da seguinte maneira: <uap:Capability Name="phoneCall" />
  • Seu aplicativo tem uma tarefa em segundo plano que associa o gatilho PhoneCallOriginDataRequestTriggerDetails .
  • Seu aplicativo pode fazer chamadas telefônicas (em Configurações -> Privacidade -> Chamadas telefônicas).

Se qualquer um deles não for verdadeiro, SetCallOrigin retornará um erro de acesso negado.

Esse método deve ser invocado em segundo plano quando o aplicativo é disparado pelo PhoneCallOriginDataRequestTriggerDetails.

O exemplo a seguir mostra como definir o local da origem em resposta a um gatilho.

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();
    }
}

Aplica-se a