Função BluetoothFindFirstRadio (bluetoothapis.h)
A função BluetoothFindFirstRadio inicia a enumeração de rádios Bluetooth locais.
Sintaxe
HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
[out] HANDLE *phRadio
);
Parâmetros
pbtfrp
Ponteiro para uma estrutura BLUETOOTH_FIND_RADIO_PARAMS . O membro dwSize da estrutura BLUETOOTH_FIND_RADIO_PARAMS apontada por pbtfrp deve corresponder ao tamanho da estrutura.
[out] phRadio
Ponteiro para onde o primeiro identificador de rádio enumerado será retornado. Quando não for mais necessário, esse identificador deverá ser fechado por meio de CloseHandle.
Retornar valor
Além do identificador indicado pelo phRadio, chamar essa função também criará um identificador de HBLUETOOTH_RADIO_FIND para uso com a função BluetoothFindNextRadio . Quando esse identificador não é mais necessário, ele deve ser fechado por meio do BluetoothFindRadioClose.
Retorna NULL após falha. Chame a função GetLastError para obter mais informações sobre o erro. A tabela a seguir descreve erros comuns:
| Código de retorno | Descrição |
|---|---|
|
Nenhum rádio Bluetooth encontrado. |
|
O parâmetro pbtfrp é NULL. |
|
A estrutura apontada por pbtfrp não é o tamanho correto. |
|
Sem memória. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | bluetoothapis.h (inclua Bthsdpdef.h, BluetoothAPIs.h) |
| Biblioteca | Bthprops.lib |
| DLL | bthprops.cpl |