ICommunicationObject Interface
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Defines the contract for the basic state machine for all communication-oriented objects in the system, including channels, the channel managers, factories, listeners, and dispatchers, and service hosts.
Assembly: System.ServiceModel (in System.ServiceModel.dll)
The ICommunicationObject type exposes the following members.
| Name | Description | |
|---|---|---|
 | Abort | Causes a communication object to transition immediately from its current state into the closed state. |
| BeginClose(AsyncCallback, Object) | Begins an asynchronous operation to close a communication object. |
| BeginClose(TimeSpan, AsyncCallback, Object) | Begins an asynchronous operation to close a communication object with a specified time-out. |
| BeginOpen(AsyncCallback, Object) | Begins an asynchronous operation to open a communication object. |
| BeginOpen(TimeSpan, AsyncCallback, Object) | Begins an asynchronous operation to open a communication object within a specified interval of time. |
| Close() | Causes a communication object to transition from its current state into the closed state. |
| Close(TimeSpan) | Causes a communication object to transition from its current state into the closed state. |
| EndClose | Completes an asynchronous operation to close a communication object. |
| EndOpen | Completes an asynchronous operation to open a communication object. |
| Open() | Causes a communication object to transition from the created state into the opened state. |
| Open(TimeSpan) | Causes a communication object to transition from the created state into the opened state within a specified interval of time. |
| Name | Description | |
|---|---|---|
 | Closed | Occurs when the communication object completes its transition from the closing state into the closed state. |
| Closing | Occurs when the communication object first enters the closing state. |
| Faulted | Occurs when the communication object first enters the faulted state. |
| Opened | Occurs when the communication object completes its transition from the opening state into the opened state. |
| Opening | Occurs when the communication object first enters the opening state. |
The ICommunicationObject interface defines:
A set of open, close, and abort methods for initiating state transitions:
Asynchronous versions of the open and close methods:
A set of events that provides notifications of state transitions:
A common State property for inspecting the state of an object.
Capabilities
If you use this API in your app, you must specify the following capabilities in the app manifest. Otherwise, your app might not work correctly or it might exit unexpectedly.
ID_CAP_NETWORKING | Windows Phone 8, Windows Phone OS 7.1 |
For more info, see App capabilities and hardware requirements for Windows Phone 8.