Freigeben über


PhoneCallOriginManager.SetCallOrigin(Guid, PhoneCallOrigin) Methode

Definition

Legt den Anrufursprung fest, wenn ein Anruf eingeht.

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)

Parameter

requestId
Guid

Platform::Guid

winrt::guid

Der eindeutige Bezeichner für diesen Telefonanruf. Dies wird von der targetId der PhoneCallOriginDataRequestTriggerDetails abgerufen.

callOrigin
PhoneCallOrigin

Die Anrufinformationen für den eingehenden Anruf.

Attribute

Windows-Anforderungen

App-Funktionen
phoneCallHistory phoneCallHistorySystem

Hinweise

Bevor Sie versuchen, diese Methode aufzurufen, stellen Sie Folgendes sicher.

  • Sie deklarieren die PhoneCall-Funktion in Ihrer App-Manifestdatei wie folgt: <uap:Capability Name="phoneCall" />
  • Ihre Anwendung verfügt über eine Hintergrundaufgabe, die den PhoneCallOriginDataRequestTriggerDetails-Trigger bindet.
  • Ihre Anwendung kann Telefonanrufe tätigen (unter Einstellungen –> Datenschutz –> Telefonanrufe).

Wenn einer dieser Werte nicht zutrifft, gibt SetCallOrigin einen Fehler zurück, der zugriff verweigert wurde.

Diese Methode sollte im Hintergrund aufgerufen werden, wenn die Anwendung von PhoneCallOriginDataRequestTriggerDetails ausgelöst wird.

Das folgende Beispiel zeigt, wie der Speicherort des Ursprungs als Reaktion auf einen Trigger festgelegt wird.

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

Gilt für: