Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
IObex provides the primary interface to the OBEX object; this interface controls every OBEX operation.
| Method | Description |
|---|---|
| IObex::BindToDevice | Provides a pointer to a device by using the property bag values of that device. |
| IObex::EnumDevices | Sorts the returned information when synchronous device enumeration is being used. |
| IObex::EnumTransports | Retrieves a list of the supported data transfer types from the OBEX object. |
| IObex::Initialize | Initializes a newly created OBEX object. |
| IObex::Shutdown | Shuts down the IObex interface. |
| IObex::StartDeviceEnum | Begins the enumeration of the available devices. |
| IObex::StopDeviceEnum | Halts the enumeration of the available 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
Pocket PC Platforms: Pocket PC 2002 and later
OS Versions: Windows CE 3.0 and later
Header: obex.h
Library: obexguid.lib
Send feedback on this topic to the authors.
© 2005 Microsoft Corporation. All rights reserved.