Share via


IObex::StartDeviceEnum (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

HRESULT StartDeviceEnum();

Parameters

None.

Return Value

This method returns one of the following values.

Return value Description

S_OK

The request was completed successfully.

E_FAIL

The request failed.

OBEX_E_NOT_INITIALIZED

Not initialized.

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::StopDeviceEnummethod. After the enumeration process is stopped, call IObex::EnumDevices to retrieve a list of the enumerated devices.

Requirements

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

See Also

Reference

IObex:IUnknown
OBEX Interfaces