Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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