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.

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.

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.

Header

obex.h,
obex.idl

Library

uuid.lib

Show: