Freigeben über

ControlChannelTriggerStatus Enumeration

  • Referenz

Definition

Namespace:
Windows.Networking.Sockets
Bearbeiten

Gibt an, ob das System die Konfiguration eines ControlChannelTrigger-Objekts zur Verwendung durch Klassenelemente in windows.Networking.Sockets und zugehörigen Namespaces abschließen konnte.

Hinweis

Diese Enumeration wird auf Windows Phone nicht unterstützt.

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
Vererbung
Enum
ControlChannelTriggerStatus
Attribute
ContractVersionAttribute PreviousContractVersionAttribute

Windows-Anforderungen

Gerätefamilie
Windows Desktop Extension SDK (eingeführt in 10.0.10240.0)
 Windows Mobile Extension SDK (eingeführt in 10.0.10240.0)
 Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract
Windows.Networking.Sockets.ControlChannelTriggerContract (eingeführt in v1.0)
 Windows.Foundation.UniversalApiContract (eingeführt in v6.0)

Felder

HardwareSlotAllocated 2

Ein Hardwareslot wurde vom System zugewiesen.
HardwareSlotRequested 0

Die Richtlinienüberprüfung war erfolgreich, und ein Hardwareslot wurde vom System angefordert.
PolicyError 3

Ein Richtlinienfehler ist aufgetreten, wenn das System versucht hat, die Konfiguration eines ControlChannelTrigger abzuschließen. Dieser Fehler kann auftreten, wenn eine App mehr Verbindungen für Hardware- oder Softwareslots angefordert hat, als von der Systemrichtlinie zulässig sind.
ServiceUnavailable 6

Der vom ControlChannelTrigger bereitgestellte Dienst ist nicht verfügbar. Dies kann passieren, wenn der Netzwerkverbindungsbrokerdienst noch nicht bereit ist, die App jedoch versucht, einen ControlChannelTrigger-Kanal einzurichten. Dieser status Code wird unter den folgenden Bedingungen bereitgestellt:

  • Wenn ein schneller Benutzerwechsel erfolgt und der neue Benutzer versucht, den ControlChannelTrigger-Kanal einzurichten.
  • Wenn das System in einen Energiesparmodus (Connected standby mode) wechselt und die App versucht, einen Softwareslot zu erstellen. Softwareslots sind nur verfügbar, wenn das System aktiv ist und nicht im Energiesparmodus.

Die Entschärfung in beiden Fällen besteht darin, auf Systemereignisbrokerereignisse zu lauschen und den ControlChannelTrigger-Kanal zu diesem Zeitpunkt zu registrieren.
SoftwareSlotAllocated 1

Die Richtlinienüberprüfung war erfolgreich, und ein Softwareslot wurde vom System zugewiesen.
SystemError 4

Ein Systemfehler ist aufgetreten, wenn das System versuchte, die Konfiguration eines ControlChannelTrigger für einen Hardwareslot abzuschließen.
TransportDisconnected 5

Der dem ControlChannelTrigger zugeordnete Netzwerktransport wurde getrennt. Die zugrunde liegende TCP-Verbindung wurde bereits durch eine TCP-Zurücksetzung getrennt, die vom Remoteziel empfangen wurde, oder durch eine ordnungsgemäße Trennung durch die App oder das Remoteziel. Das häufigste Vorkommen ist eine TCP-Zurücksetzung oder eine ordnungsgemäße Trennung, die vom Remoteziel gesendet wird.

Hinweise

Das System verwaltet eine Richtlinie für die Anzahl der ControlChannelTrigger-Instanzen , die für eine UWP-App konfiguriert werden können, um die Ressourcennutzung zu begrenzen und die Akkulaufzeit zu verlängern. Sobald die Konfiguration durch das System abgeschlossen ist, stellt jede ControlChannelTrigger-instance entweder einen Hardware- oder Softwaresteckplatz für eine hergestellte TCP-Verbindung dar, die auch dann beibehalten werden soll, wenn die App angehalten wird (vom Vordergrund in den Hintergrund verschoben).

Ein lokales Computersystem kann sich in mehreren Energiezuständen befinden:

  • System aktiv
  • Verbundener Standbymodus
  • Herunterfahren Eine App im aktiven Systemmodus kann einen Steuerungskanaltrigger empfangen, wenn ein Software- oder Hardwareslot verwendet wird. Eine App im verbundenen Standbymodus kann nur dann einen Steuerkanaltrigger empfangen, wenn ein Hardwaresteckplatz verwendet wird.

Gilt für:

Weitere Informationen