Função BluetoothEnumerateInstalledServices (bluetoothapis.h)

Artigo
02/23/2024

A função BluetoothEnumerateInstalledServices enumera os GUIDs de serviços (Identificadores Globalmente Exclusivos) habilitados em um dispositivo Bluetooth.

Sintaxe

DWORD BluetoothEnumerateInstalledServices(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  DWORD                       *pcServiceInout,
  GUID                        *pGuidServices
);

Parâmetros

hRadio

Identificador do dispositivo de rádio Bluetooth local. Se NULL, todas as rádios locais serão pesquisadas por serviços habilitados que correspondam ao endereço de rádio em pbtdi.

pbtdi

Ponteiro para uma estrutura BLUETOOTH_DEVICE_INFO .

pcServiceInout

Na entrada, o número de registros apontados pelo parâmetro pGuidServices . Na saída, o número de registros válidos retornados no parâmetro pGuidServices . Se pGuidServices for NULL, em pcServices de saída conterá o número de serviços habilitados.

pGuidServices

Ponteiro para um buffer na memória para receber GUIDs para serviços instalados. O buffer deve ser pelo menos *pcServices *sizeof(GUID) bytes.

Retornar valor

Retorna ERROR_SUCCESS após a conclusão bem-sucedida e o parâmetro pGuidServices contém uma lista completa de GUIDs de serviço habilitados.

A tabela a seguir descreve um erro comum:

Código de retorno	Descrição
ERROR_MORE_DATA	A chamada foi bem-sucedida. O parâmetro pGuidServices contém uma lista incompleta de GUIDs de serviço habilitados.

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