Share via


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

Header

wrlspwr.h

See Also

Reference

Wireless Device Power Management Structures