ControlChannelTrigger.ControlChannelTrigger(String, UInt32) constructor

Creates a new ControlChannelTrigger object with a control channel trigger ID and a value for the server keep-alive interval.

Note  The ControlChannelTrigger class is not supported on Windows Phone.

Syntax


public ControlChannelTrigger(
  string channelId, 
  uint serverKeepAliveIntervalInMinutes
)

Parameters

channelId

Type: System.String [.NET] | Platform::String [C++]

A string used to differentiate various control channel triggers on the local computer. The maximum length allowed for this string is 64 characters.

serverKeepAliveIntervalInMinutes

Type: System.UInt32 [.NET] | uint32 [C++]

The keep-alive interval, in minutes, registered with the system to indicate when the app and network connections used should wake up.

The minimum value that can be set for this parameter is 15 minutes. The maximum value that can be set is 1439 minutes (approximately 24 hours).

Remarks

The ControlChannelTrigger(String, UInt32) constructor creates a ControlChannelTrigger object. By default, the resource type requested for the control channel trigger is a ControlChannelTriggerResourceType set to RequestSoftwareSlot.

If an app needs a hardware slot to support connected standby, then the ControlChannelTrigger(String, UInt32, ControlChannelTriggerResourceType) constructor should be used to create the ControlChannelTrigger object since this allows an app to specific the requested resource type.

Requirements (device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (operating system)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported

Namespace

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

Metadata

Windows.winmd

See also

Other resources
How to set background connectivity options
Reference
ControlChannelTrigger
ControlChannelTrigger(String, UInt32, ControlChannelTriggerResourceType)
ControlChannelTriggerResourceType

 

 

Show:
© 2015 Microsoft