Compartir a través de


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