RDD (Compact 7)

3/12/2014

This structure stores information about a wireless device.

Syntax

typedef struct { 
    RDD() : pszDeviceName(NULL), pNext(NULL), pszDisplayName(NULL) {}
    ~RDD() { LocalFree(pszDeviceName); LocalFree(pszDisplayName); }
    LPTSTR   pszDeviceName;
    LPTSTR   pszDisplayName;
    DWORD    dwState;
    DWORD    dwDesired;
    RADIODEVTYPE    DeviceType;
    RDD * pNext;
} RDD;

Members

• pszDeviceName
  Name of the wireless device to be stored in the registry.

• pszDisplayName
  Display name of the wireless device.

• dwState
  Actual state of the wireless device. The following table shows the possible values.

  State	Value	Description
  ON	0	Power down the wireless device.
  OFF	1	Power up the wireless device.
  DISCOVERABLE	2	Set the wireless device to be discovered by peer Bluetooth devices.

• dwDesired
  Desired state of the wireless device. Takes the same values as dwState, but this represents the state the device should assume when wireless is turned on regardless of the current state.

• DeviceType
  Type of wireless device. The possible values are defined in the RADIODEVTYPE enumeration.

• pNext
  Pointer to the next device in the list.

Remarks

If you use the GetWirelessDevices function to retrieve a list of RDD structures, you must free the list when it is no longer required.

To avoid unnecessary registry queries, GetWirelessDevices only populates the dwDesired member if the WIRELESS_GET_DESIRED flag is passed in the dwFlags parameter.

Requirements

See Also

Reference

Wireless Device Power Management Structures