IObex:IUnknown (Windows Embedded CE 6.0)

  • Article

1/6/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

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

Header obex.h, obex.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

OBEX Interfaces
IDeviceEnum:IUnknown
IHeaderCollection:IUnknown
IHeaderEnum:IUnknown
IObexDevice:IUnknown
IObexSink:IUnknown