Microsoft.SmartDevice.Connectivity Namespace

  • Article

This namespace contains types that make up the desktop side of the Smart Device Connectivity API. Use the Smart Device Connectivity API in your managed applications to establish a desktop-to-device connection. This API enables you to focus on writing remote tools and plug-ins, while the Smart Device Connectivity API handles the device interconnectivity and transport mechanisms details.

Visual Studio Remote Tools for Device Projects such as Remote File Viewer and Remote Process Viewer are good examples of what you can do with the Smart Device Connectivity API. For more information, see Controlling Devices with the Smart Device Connectivity API.

The classes in this namespace are classified into the following categories.

Category

Description

Classes

Datastore enumeration APIs

Enumerates the list of platforms and devices listed in the Datastore.

DatastoreManager

Platform

Connectivity APIs

Gets device information and establishes a connection to the device.

Device

Deployment and service APIs

Deploys files and packages, lists remote files and processes, starts services, and other services.

FileDeployer

RemoteProcess

Custom data exchange APIs

Exchanges custom data between the desktop application and a device agent application.

RemoteAgent

DevicePacketStream

Packet

Microsoft.SmartDevice.DeviceAgentTransport

Classes

  Class Description
Public class DatastoreException Thrown when there is a problem related to the Datastore.
Public class DatastoreManager Accesses information in the Datastore and provides methods to enumerate and get Platform objects in the desktop computer's Datastore.
Public class Device Represents a device or emulator that is based on Windows Embedded CE and provides methods to provision, get information, and connect to a device.
Public class DeviceNotConnectedException Thrown in scenarios where the device is not connected.
Public class DeviceNotFoundException Represents all exceptions in scenarios where the device is not found.
Public class DevicePacketStream Exchanges data between a desktop application and a device agent application by reading and writing objects of type Packet.
Public class FileDeployer Used to transfer files between the smart device and the desktop computer.
Public class ObjectId Encapsulates the unique ID required for various classes of this assembly.
Public class Packet Holds data and is used by the DevicePacketStream class to transfer data between a smart device and a desktop computer.
Public class Platform Represents a Windows CE based platform, such as Windows Mobile 5.0 Pocket PC, that is registered in the Datastore.
Public class PlatformNotFoundException Thrown when the platform cannot be found.
Public class PropertyNotFoundException Represents all exceptions in scenarios where the property is not found.
Public class RemoteAgent Used to deploy device agent applications to the device and exchange data between the desktop computer and the smart device.
Public class RemoteProcess Represents a process on the device that can be started and stopped.
Public class SmartDeviceException Covers the exception cases in unmanaged COM layer.
Public class SystemInfo Stores device information such as CPU information, battery life, amount of memory, and operating system version.

Enumerations

  Enumeration Description
Public enumeration DataType Indicates the type of object in the Packet.
Public enumeration Device.ConfigActions Specifies the action to take when provisioning a device.
Public enumeration InstructionSetType Indicates the instruction set type of the device's CPU.
Public enumeration ProcessorArchitectureType Indicates the device's processor architecture type.

See Also

Reference

Other Resources

Controlling Devices with the Smart Device Connectivity API

Smart Device Connectivity API Samples