IObex (Compact 2013)
3/26/2014
This interface is the main interface to the Object Exchange (OBEX) Protocol services. The IObex object exports a standard COM IConnectionPointContainer interface. This interface is used to call IConnectionPoint::Adviseand IConnectionPoint::Unadvise to register notifications on the object.
In This Section
- 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. See CoCreateInstance. 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
Header |
obex.h, |
Library |
uuid.lib |
See Also
Reference
OBEX Interfaces
IDeviceEnum
IHeaderCollection
IHeaderEnum
IObexDevice
IObexSink