IObex:IUnknown (Windows CE 5.0)
This interface is the main interface to the OBEX services. The IObex object exports a standard COM IConnectionPointContainer interface. This interface is used to call Advise and Unadvise to register notifications on the object.
The following table shows the methods of this interface.
| Method | Description |
|---|---|
| BindToDevice | Returns a pointer to the IObexDevice interface. |
| EnumDevices | Returns a pointer to the IDeviceEnum interface. |
| EnumTransports | Returns a pointer to the ITransportEnum interface. |
| Initialize | Initializes the IObex interface. This method must be called before any other method. |
| Shutdown | Shuts down the IObex interface. |
| StartDeviceEnum | Starts the process of enumerating devices. |
| StopDeviceEnum | Stops the process of enumerating devices. |
Remarks
To create an OBEX object, it must be co-created first. After the object is co-created, the globally unique identifier (GUID) of the object is available; the next step is to call IObex::Initialize. Call IObex::Shutdown to close the connection to the currently open object.
There are two options for gathering a list of devices when working with the OBEX transfer protocol:
- Asynchronous enumeration
- Synchronous enumeration
To perform an asynchronous enumeration of all devices, the local device must first be advised to the OBEX object. This process of advising the local device provides a pointer to the name of the local device, allowing the OBEX object to call that device back after it has gathered information. The IObex::StartDeviceEnum and IObex::StopDeviceEnum methods control the asynchronous enumeration process.
Requirements
Smartphone: Smartphone 2002 and later
Pocket PC: Pocket PC 2002 and later
OS Versions: Windows CE .NET 4.0 and later.
Header: Obex.h, Obex.idl.
Link Library: Uuid.lib.
See Also
IDeviceEnum | IHeaderCollection | IHeaderEnum | IObexDevice | IObexSink | OBEX Interfaces
Send Feedback on this topic to the authors