PhoneCallOriginManager.SetCallOrigin(Guid, PhoneCallOrigin) メソッド

定義

名前空間:

Windows.ApplicationModel.Calls.Provider

通話の着信元を設定します。

public:
 static void SetCallOrigin(Platform::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")]
 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")]
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

この電話の一意識別子。 これは、PhoneCallOriginDataRequestTriggerDetails の targetId から取得されます。

callOrigin

PhoneCallOrigin

着信呼び出しの呼び出し情報。

属性

DeprecatedAttribute

Windows の要件

アプリの機能

phoneCallHistory phoneCallHistorySystem

注釈

このメソッドを呼び出す前に、次の内容を確認してください。

• 次のように、アプリ マニフェスト ファイルで PhoneCall 機能を宣言します。 <uap:Capability Name="phoneCall" />
• アプリケーションには、 PhoneCallOriginDataRequestTriggerDetails トリガーをバインドするバックグラウンド タスクがあります。
• アプリケーションで電話をかけることができます ([設定] - [プライバシー] ->> [電話] の下)。

これらのいずれかが true でない場合、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();
    }
}