IObex (Compact 2013)

  • Article

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

  • Initialize
    Initializes the IObex interface. This method must be called before any other method.
  • Shutdown
    Shuts down the IObex interface.

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,
obex.idl

Library

uuid.lib

See Also

Reference

OBEX Interfaces
IDeviceEnum
IHeaderCollection
IHeaderEnum
IObexDevice
IObexSink