estrutura SOCKADDR_BTH (ws2bth.h)

A estrutura SOCKADDR_BTH é usada em conjunto com operações de soquete Bluetooth, definidas por AF_BTH da família de endereços.

Sintaxe

typedef struct _SOCKADDR_BTH {
  USHORT   addressFamily;
  BTH_ADDR btAddr;
  GUID     serviceClassId;
  ULONG    port;
} SOCKADDR_BTH, *PSOCKADDR_BTH;

Membros

addressFamily

Família de endereços do soquete. Esse membro está sempre AF_BTH.

btAddr

Endereço do dispositivo Bluetooth de destino. Quando usado com a função bind , deve ser zero ou um endereço de rádio local válido. Se zero, um endereço de dispositivo Bluetooth local válido será atribuído quando a função connect ou accept for chamada. Quando usado com a função connect , um endereço de rádio remoto válido deve ser especificado.

serviceClassId

Identificador de Classe de Serviço do soquete. Quando usado com a função bind , serviceClassId é ignorado. Também será ignorado se a porta for especificada. Para a função connect , especifica a ID de classe de serviço Bluetooth exclusiva do serviço ao qual ele deseja se conectar. Se o dispositivo par tiver mais de uma porta que corresponda ao identificador de classe de serviço, a função connect tentará se conectar ao primeiro serviço válido; esse mecanismo pode ser usado sem consultas SDP anteriores.

port

Canal RFCOMM associado ao soquete. Consulte Observações.

Comentários

Quando usado com a função bind em aplicativos cliente, o membro da porta deve ser zero para permitir que um ponto de extremidade local apropriado seja atribuído. Quando usado com associação em aplicativos de servidor, o membro da porta deve ser um número de porta válido ou BT_PORT_ANY; as portas atribuídas automaticamente usando BT_PORT_ANY podem ser consultadas posteriormente com uma chamada para a função getsockname . O intervalo válido para solicitar uma porta RFCOMM específica é de 1 a 30.

Ao usar a função connect quando serviceClassId não é fornecido, a porta deve especificar diretamente o número da porta remota para a qual uma operação de conexão é solicitada. Usar o membro da porta em vez do membro serviceClassId requer que o aplicativo execute sua própria pesquisa de serviço (SDP) antes de tentar a operação de conexão .

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
Cabeçalho ws2bth.h

Confira também

Bluetooth e associação

Bluetooth e getsockname

Bluetooth e aceitar

Bluetooth e conexão