Función BluetoothFindFirstRadio (bluetoothapis.h)

La función BluetoothFindFirstRadio comienza la enumeración de radios Bluetooth locales.

Sintaxis

HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
        const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
  [out] HANDLE                            *phRadio
);

Parámetros

pbtfrp

Puntero a una estructura de BLUETOOTH_FIND_RADIO_PARAMS . El miembro dwSize de la estructura BLUETOOTH_FIND_RADIO_PARAMS a la que apunta pbtfrp debe coincidir con el tamaño de la estructura.

[out] phRadio

Puntero a donde se devolverá el primer identificador de radio enumerado. Cuando ya no sea necesario, este identificador debe cerrarse a través de CloseHandle.

Valor devuelto

Además del identificador indicado por phRadio, al llamar a esta función también se creará un controlador de HBLUETOOTH_RADIO_FIND para su uso con la función BluetoothFindNextRadio . Cuando este controlador ya no es necesario, debe cerrarse a través de BluetoothFindRadioClose.

Devuelve NULL tras un error. Llame a la función GetLastError para obtener más información sobre el error. En la tabla siguiente se describen los errores comunes:

Código devuelto	Descripción
ERROR_NO_MORE_ITEMS	No se encontraron radios Bluetooth.
ERROR_INVALID_PARAMETER	El parámetro pbtfrp es NULL.
ERROR_REVISION_MISMATCH	La estructura a la que apunta pbtfrp no es el tamaño correcto.
ERROR_OUTOFMEMORY	Memoria insuficiente

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	bluetoothapis.h (incluye Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
Archivo DLL	bthprops.cpl

Consulte también

BLUETOOTH_FIND_RADIO_PARAMS

BluetoothFindNextRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

Obtener último error