controlchanneltrigger_controlchanneltrigger_381309182.md

-api-id	-api-type
M:Windows.Networking.Sockets.ControlChannelTrigger.#ctor(System.String,System.UInt32)	winrt method

Windows.Networking.Sockets.ControlChannelTrigger.ControlChannelTrigger

-description

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.

-parameters

-param channelId

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

-param serverKeepAliveIntervalInMinutes

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.

-examples

-see-also

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