Partager via


PhoneCallOriginManager.SetCallOrigin(Guid, PhoneCallOrigin) Méthode

Définition

Définit l’origine de l’appel lorsqu’un appel téléphonique arrive.

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)

Paramètres

requestId
Guid

Platform::Guid

winrt::guid

Identificateur unique de cet appel téléphonique. Cette valeur est récupérée à partir de l’id cible de PhoneCallOriginDataRequestTriggerDetails

callOrigin
PhoneCallOrigin

Informations d’appel pour l’appel entrant.

Attributs

Configuration requise pour Windows

Fonctionnalités de l’application
phoneCallHistory phoneCallHistorySystem

Remarques

Avant d’essayer d’appeler cette méthode, vérifiez les points suivants.

  • Vous déclarez la fonctionnalité PhoneCall dans votre fichier manifeste d’application comme suit : <uap:Capability Name="phoneCall" />
  • Votre application a une tâche en arrière-plan qui lie le déclencheur PhoneCallOriginDataRequestTriggerDetails .
  • Votre application peut passer des appels téléphoniques (sous Paramètres -> Confidentialité -> Appels téléphoniques).

Si l’une de ces valeurs n’est pas vraie, SetCallOrigin renvoie une erreur d’accès refusé.

Cette méthode doit être appelée en arrière-plan lorsque l’application est déclenchée par PhoneCallOriginDataRequestTriggerDetails.

L’exemple suivant montre comment définir l’emplacement de l’origine en réponse à un déclencheur.

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

S’applique à