Platform Manager API (Windows CE 5.0)
The Platform Manager API exposes functionality that enables you to develop a remote tool. For example, the Platform Manager API exposes interfaces and methods that simplify registering an application on a target device, downloading packages from the desktop to the device, and exchanging information between the development workstation and the target device. For more information, see Remote Tool Connectivity.
The following table shows the interfaces that are exposed by the Platform Manager API. In the top-level Platman directory for Platform Manager, the .h and .idl files for these interfaces are located at Sdk\Wce500\Platman\Include.
Note Core Connectivity replaces Platform Manager and provides a connectivity infrastructure that is similar to the infrastructure that Platform Manager provides. Use the Core Connectivity API. Do not use the Platform Manager API except in existing code that does not need to be compatible with future releases of Windows CE. For more information about Core Connectivity, see Core Connectivity Infrastructure.
| Interface | Description |
|---|---|
| IPMPlatformManager | Provides access to any other interface exposed by Platform Manager. It is the root-level interface for Platform Manager. |
| IPMPlatform | Provides the ability to access and change a specified platform object registered within Platform Manager. |
| IPMRemoteDevice | Provides the ability to access and change a specified device object associated with a run-time image. A device object stores the information required to establish an application-level connection between the development workstation and a target device. For more information, see Application Connectivity. |
| IPMProperty | Provides the ability to access and change a specified property object. |
| IPMPackage | Provides the ability to access and change a specified package object. Package objects can be associated either with Platform Manager or a specific platform object. |
| IPMConnectionStream | Provides the ability to access and change a specified connection stream object. |
| IPMConnection | Provides the ability to access and change a specified connection object. The connection object is created by the IPMRemoteDevice::Attach method. |
| IPMCPU | Provides the ability to access and change a specified CPU object. |
| IPMOS | Provides the ability to access and change a specified operating system (OS) object. |
| IPMPropInfo | Provides the ability to access and change a specified property information object. A property information object holds a registry key value for a property. A property object might have one or more property information objects. Each property information object corresponds to a registry key value for the property. |
| IPMPackageFile | Provides the ability to access and change a specified package file object. |
| IEnumVariant | Provides methods for representing a collection of objects. All enumeration objects within Platform Manager use this interface. |
A remote tool client creates the root Platform Manager object with the CreateObject method. The root Platform Manager object then implements the IPMPlatformManager interface. The IPMPlatformManager::AddXXX and IPMPlatformManager::GetXXX methods create additional Platform Manager objects. The XXX::AddXXX and XXX::GetXXX methods of the objects created by the IPMPlatformManager::AddXXX and IPMPlatformManager::GetXXX methods create other Platform Manager objects, and so on.
The Platform Manager API provides a single enumeration interface called IEnumVariant. The IEnumVariant interface provides the ability to access any group of Platform Manager objects as a collection. Using the IEnumVariant::Count method in conjunction with the IEnumVariant::Item method, you can cycle through a group of objects one object at a time. The IEnumVariant interface implements the standard IEnumVARIANT interface.
See Also
Platform Manager Object Model | Platform Manager Samples
Send Feedback on this topic to the authors