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.
HRESULT StartDeviceEnum();
Parameters
None.
Return Values
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::StopDeviceEnum method. After the enumeration process is stopped, call IObex::EnumDevices to retrieve a list of the enumerated devices.
Requirements
Smartphone: Smartphone 2002 and later
Pocket PC: Pocket PC 2002 and later
OS Versions: Windows CE .NET 4.0 and later.
Header: Obex.h, Obex.idl.
Link Library: Uuid.lib.
See Also
Send Feedback on this topic to the authors