IObex:IUnknown
A version of this page is also available for
4/8/2010
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 |
|---|---|
Returns a pointer to the IObexDevice interface. |
|
Returns a pointer to the IDeviceEnum interface. |
|
Returns a pointer to the ITransportEnum interface. |
|
Initializes the IObex interface. This method must be called before any other method. |
|
Shuts down the IObex interface. |
|
Starts the process of enumerating devices. |
|
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
| Header | obex.h, obex.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |
See Also
Reference
IDeviceEnum:IUnknown
IHeaderCollection:IUnknown
IHeaderEnum:IUnknown
IObexDevice:IUnknown
IObexSink:IUnknown
OBEX Interfaces