BthGetHardwareStatus (Windows Embedded CE 6.0)

1/6/2010

This function obtains the hardware status.

Syntax

int BthGetHardwareStatus(
  int* pistatus
);

pistatus
[out] Pointer to an integer that returns the hardware status.

The following table shows the possible values.

Value	Description
HCI_HARDWARE_UNKNOWN	The stack is not present.
HCI_HARDWARE_RUNNING	The adapter is installed and the stack is running.
HCI_HARDWARE_INITIALIZING	The adapter might be installed. The stack is currently on the way up. Call again later.
HCI_HARDWARE_ERROR	The adapter might be installed. The stack is on the way down. Call again later.
HCI_HARDWARE_SHUTDOWN	The adapter is installed, but the stack is not running.
HCI_HARDWARE_NOT_PRESENT	The adapter is not present.

This function returns ERROR_SUCCESS when it completes successfully.

A return value of ERROR_SERVICE_NOT_ACTIVE indicates that the hardware is not inserted or that the Bluetooth stack is not present.

Other standard error codes may be returned as appropriate.