IPMPlatform:IDispatch (Windows CE 5.0)
This interface provides the ability to access and change a specified platform object registered with Platform Manager. The platform object is created by adding a new platform or by retrieving an existing platform through the root-level IPMPlatformManager interface.
Platform Builder allows an OEM to create a software development kit (SDK) for a platform. When you install the SDK, Platform Manager automatically registers a new platform object for the platform.
The following code sample shows one technique for accessing a platform object from an Automation client.
Dim tPlatform as Object
For Each tPlatform in tPlatman.EnumPlatforms
' Access the platform object here.
Next tPlatform
The following code sample shows a second technique for accessing a platform object from an Automation client.
Dim nIndex as Integer
For nIndex = 1 to tPlatman.EnumPlatforms.Count
Set tPlatform = tPlatman.EnumPlatforms.Item(nIndex)
' Access the platform object here.
Next
The following table shows this interface's methods.
| Method | Description |
|---|---|
| IPMPlatform::Id | Retrieves the GUID associated with the platform object. |
| IPMPlatform::Name | Retrieves or sets the name of the platform object. |
| IPMPlatform::EnumProperties | Enumerates the properties associated with the platform object. |
| IPMPlatform::GetProperty | Obtains a property object for a specified bstrPropId element. |
| IPMPlatform::AddProperty | Adds a property object to the IPMPlatform interface and returns this object. |
| IPMPlatform::DeleteProperty | Deletes the property object corresponding to a specified bstrPropId element. |
| IPMPlatform::EnumDevices | Enumerates the remote device objects within the platform. |
| IPMPlatform::GetDevice | Obtains a remote device object for a specified bstrDeviceIdOrName element. |
| IPMPlatform::AddDevice | Adds a remote device object to the IPMPlatform interface of type bstrDeviceName and returns this object. |
| IPMPlatform::DeleteDevice | Deletes the remote device object corresponding to a specified bstrDeviceIdOrName element. |
| IPMPlatform::EnumCPUs | Enumerates the CPU objects associated with the platform object. |
| IPMPlatform::GetCPU | Obtains a CPU object for a specified bstrCPUIdOrName element. |
| IPMPlatform::AddCPU | Associates a CPU object registered with Platform Manager with the platform and returns this object. |
| IPMPlatform::DeleteCPU | Removes the association of a CPU object with the platform. |
| IPMPlatform::GetOS | Obtains the operating system (OS) object associated with the platform. |
| IPMPlatform::AddOS | Associates an OS object registered with Platform Manager with the platform object. |
| IPMPlatform::DeleteOS | Removes the association of an OS object with the platform. |
| IPMPlatform::EnumPackages | Enumerates the package objects within the platform. |
| IPMPlatform::GetPackage | Obtains a package object for a specified bstrPackageIdOrName element. |
| IPMPlatform::AddPackage | Adds a package object to the IPMPlatform interface of type bstrPackageName and returns the object. |
| IPMPlatform::DeletePackage | Deletes the package object corresponding to a specified bstrPackageIdOrName element. |
| IPMPlatform::EnumStartupServers | Enumerates the startup server objects within the platform. |
| IPMPlatform::GetStartupServer | Obtains a startup server object for a specified bstrStartupServerIdOrName element. |
| IPMPlatform::AddStartupServer | Adds a startup server object to the IPMPlatform interface of type bstrStartupServerId and returns the object. |
| IPMPlatform::DeleteStartupServer | Deletes the startup server object corresponding to a specified bstrStartupServerIdOrName element. |
| IPMPlatform::EnumTransports | Enumerates the transport objects within the platform. |
| IPMPlatform::GetTransport | Obtains a transport object for a specified bstrTransportIdOrName element. |
| IPMPlatform::AddTransport | Adds a transport object to the IPMPlatform interface of type bstrTransportId and returns the object. |
| IPMPlatform::DeleteTransport | Deletes the transport object corresponding to a specified bstrTransportIdOrName element. |
| IPMPlatform::GetOSInfo | Retrieves the major and minor version numbers of the operating system associated with the platform. |
| IPMPlatform::UniversalSDK | Obtains or sets the GUID corresponding to a Universal SDK. |
| IPMPlatform::RemoteDbgDirectory | Obtains the location of the remote debug directory. |
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Platform.h, Cemgr.idl.
See Also
Platform Manager API | IPMPlatformManager
Send Feedback on this topic to the authors