BluetoothEnableIncomingConnections function

The BluetoothEnableIncomingConnections function modifies whether a local Bluetooth radio accepts incoming connections.

Syntax


BOOL BluetoothEnableIncomingConnections(
  HANDLE hRadio,
  BOOL fEnabled
);

Parameters

hRadio

Valid local radio handle for which to change whether incoming connections are enabled, or NULL. If NULL, the attempt to modify incoming connection acceptance iterates through all local radios; if any radio is modified by the call, the function call succeeds.

fEnabled

Flag specifying whether incoming connection acceptance is to be enabled or disabled. Set to TRUE to enable incoming connections, set to FALSE to disable incoming connections.

Return value

Returns TRUE if the incoming connection state was successfully changed. If hRadio is NULL, a return value of TRUE indicates that at least one local radio state was successfully changed. Returns FALSE if incoming connection state was not changed; if hRadio was NULL, no radio accepted the state change.

Remarks

A radio that is non-connectable is non-discoverable. The radio must be made non-discoverable prior to making a radio non-connectable. Failure to make a radio non-discoverable prior to making it non-connectable will result in failure of the BluetoothEnableIncomingConnections function call.

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

None supported

Header

BluetoothAPIs.h (include Bthsdpdef.h or BluetoothAPIs.h)

Library

Bthprops.lib

DLL

Bthprops.dll

See also

BluetoothAuthenticateDevice
BluetoothAuthenticateMultipleDevices
BluetoothEnableDiscovery
BluetoothIsConnectable
BluetoothIsDiscoverable
BluetoothRegisterForAuthentication
BluetoothSendAuthenticationResponse
BluetoothUnregisterAuthentication

 

 

Community Additions

ADD
Show:
© 2014 Microsoft