IObex::StartDeviceEnum

Begins the enumeration of the available devices. This method will only begin if the OBEX object has been advised of the local device.

HRESULT StartDeviceEnum( void );

Parameters

None.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    The method completed successfully.

Remarks

After an OBEX object has been advised of the local device, StartDeviceEnum will notify that device when the OBEX object finds a new device. The information related to this new device will be sent to the local device in the form of a property bag (a list of the device's properties). After the local device has retrieved this property bag from another device, the IObex::BindToDevice method must be used to connect to that device and transfer data.

To stop the enumeration process at any time, use the IObex::StopDeviceEnum method. After the enumeration process is stopped, call IObex::EnumDevices to retrieve a list of the enumerated devices.

Requirements

Pocket PC Platforms: Pocket PC 2002 and later
OS Versions: Windows CE 3.0 and later
Header: obex.h
Library: obexguid.lib

See Also

IObex::BindToDevice

IObex::EnumDevices

IObex::StopDeviceEnum

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.