ControlChannelTriggerStatus 列挙型

  • リファレンス

定義

名前空間:
Windows.Networking.Sockets
編集

システムが、Windows.Networking.Sockets および関連する名前空間のクラス要素によって使用される ControlChannelTrigger オブジェクトの構成を完了できたかどうかを指定します。

注意

この列挙は、Windows Phoneではサポートされていません。

public enum class ControlChannelTriggerStatus
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.Sockets.ControlChannelTriggerContract, 65536)]
enum class ControlChannelTriggerStatus
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.PreviousContractVersion("Windows.Networking.Sockets.ControlChannelTriggerContract", 65536, 196608)]
enum class ControlChannelTriggerStatus
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.Sockets.ControlChannelTriggerContract), 65536)]
public enum ControlChannelTriggerStatus
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.PreviousContractVersion("Windows.Networking.Sockets.ControlChannelTriggerContract", 65536, 196608)]
public enum ControlChannelTriggerStatus
Public Enum ControlChannelTriggerStatus
継承
Enum
ControlChannelTriggerStatus
属性
ContractVersionAttribute PreviousContractVersionAttribute

Windows の要件

デバイス ファミリ
Windows Desktop Extension SDK (10.0.10240.0 で導入)
 Windows Mobile Extension SDK (10.0.10240.0 で導入)
 Windows 10, version 1803 (10.0.17134.0 で導入)
API contract
Windows.Networking.Sockets.ControlChannelTriggerContract (v1.0 で導入)
 Windows.Foundation.UniversalApiContract (v6.0 で導入)

フィールド

HardwareSlotAllocated 2

ハードウェア スロットがシステムによって割り当てられた。
HardwareSlotRequested 0

ポリシーチェック成功し、システムからハードウェア スロットが要求されました。
PolicyError 3

システムが ControlChannelTrigger の構成を完了しようとしたときに、ポリシー エラーが発生しました。 このエラーは、システム ポリシーで許可されている数よりも多くのハードウェアまたはソフトウェア スロットの接続をアプリが要求した場合に発生する可能性があります。
ServiceUnavailable 6

ControlChannelTrigger によって提供されるサービスは使用できません。 これは、ネットワーク接続ブローカー サービスの準備がまだできていないが、アプリが ControlChannelTrigger チャネルを確立しようとしている場合に発生する可能性があります。 この状態コードは、次の条件で提供されます。

  • ユーザーの切り替えが高速で、新しいユーザーが ControlChannelTrigger チャネルを確立しようとしている場合。
  • システムが低電力モード (コネクト スタンバイ モード) に入り、アプリがソフトウェア スロットを作成しようとしている場合。 ソフトウェア スロットは、システムがアクティブであり、低電力モードでない場合にのみ使用できます。

どちらの場合も軽減策は、システム イベント ブローカー イベントをリッスンし、その時点で ControlChannelTrigger チャネルを登録することです。
SoftwareSlotAllocated 1

ポリシーチェック成功し、ソフトウェア スロットがシステムによって割り当てられています。
SystemError 4

システムがハードウェア スロットの ControlChannelTrigger の構成を完了しようとしたときに、システム エラーが発生しました。
TransportDisconnected 5

ControlChannelTrigger に関連付けられているネットワーク トランスポートが切断されました。 基になる TCP 接続は、リモート接続先から受信した TCP リセットまたはアプリまたはリモートの宛先による正常な切断によって既に切断されています。 最も一般的に発生するのは、リモート宛先から送信された TCP リセットまたは正常な切断です。

注釈

システムは、UWP アプリ用に構成できる ControlChannelTrigger インスタンスの数に関するポリシーを保持して、リソースの使用量を制限し、バッテリ寿命を延ばします。 システムによる構成が完了すると、各 ControlChannelTrigger インスタンスは、アプリが中断 (フォアグラウンドからバックグラウンドに移動) された場合でも維持される、確立された TCP 接続のハードウェアまたはソフトウェア スロットを表します。

ローカル コンピューター システムは、いくつかの電源状態にすることができます。

  • システムがアクティブ
  • コネクト スタンバイ
  • シャットダウン システムアクティブモードのアプリは、ソフトウェアまたはハードウェアスロットが使用されたときに制御チャネルトリガーを受け取ることができます。 コネクト スタンバイ モードのアプリは、ハードウェア スロットが使用されている場合にのみコントロール チャネル トリガーを受け取ることができます。

適用対象

こちらもご覧ください