estrutura BLUETOOTH_SELECT_DEVICE_PARAMS (bluetoothapis.h)
A estrutura BLUETOOTH_SELECT_DEVICE_PARAMS facilita e gerencia a visibilidade, a autenticação e a seleção de dispositivos e serviços Bluetooth.
Sintaxe
typedef struct _BLUETOOTH_SELECT_DEVICE_PARAMS {
DWORD dwSize;
ULONG cNumOfClasses;
BLUETOOTH_COD_PAIRS *prgClassOfDevices;
LPWSTR pszInfo;
HWND hwndParent;
BOOL fForceAuthentication;
BOOL fShowAuthenticated;
BOOL fShowRemembered;
BOOL fShowUnknown;
BOOL fAddNewDeviceWizard;
BOOL fSkipServicesPage;
PFN_DEVICE_CALLBACK pfnDeviceCallback;
LPVOID pvParam;
DWORD cNumDevices;
PBLUETOOTH_DEVICE_INFO pDevices;
} BLUETOOTH_SELECT_DEVICE_PARAMS;
Membros
dwSize
Tamanho, em bytes, da estrutura BLUETOOTH_SELECT_DEVICE_PARAMS .
cNumOfClasses
Número de classes em prgClassOfDevices. Defina como zero para pesquisar todos os dispositivos.
prgClassOfDevices
Matriz de classe de dispositivos a serem localizados.
pszInfo
Define o texto das informações quando não é NULL.
hwndParent
Identificador para a janela pai. Defina como NULL para nenhum pai.
fForceAuthentication
Se TRUE, força a autenticação antes de retornar.
fShowAuthenticated
Se TRUE, os dispositivos autenticados serão mostrados no seletor.
fShowRemembered
Se TRUE, os dispositivos lembrados serão mostrados no seletor.
fShowUnknown
Se TRUE, dispositivos desconhecidos que não são autenticados ou lembrados são mostrados no seletor.
fAddNewDeviceWizard
Se TRUE, iniciará o assistente Adicionar Novo Dispositivo.
fSkipServicesPage
Se TRUE, ignorará a página Serviços no assistente Adicionar Novo Dispositivo.
pfnDeviceCallback
Um ponteiro para uma função de retorno de chamada que é chamada para cada dispositivo. Se a função de retorno de chamada retornar TRUE, o item será adicionado. Se a função de retorno de chamada retornar FALSE, o item não será mostrado. Defina pfnDeviceCallback como nulo para nenhum retorno de chamada. Para obter mais informações, consulte PFN_DEVICE_CALLBACK.
pvParam
Parâmetro a ser passado como pvParam para a função de retorno de chamada apontada em pfnDeviceCallback.
cNumDevices
Na entrada, especifica o número de chamadas desejadas. Defina como zero sem limite. Na saída, retorna o número de dispositivos retornados.
pDevices
Ponteiro para uma matriz de estruturas BLUETOOTH_DEVICE_INFO .
Comentários
Para liberar a matriz de estruturas BLUETOOTH_DEVICE_INFO passadas no membro pDevices , chame a função BluetoothSelectDevicesFree .
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 | bluetoothapis.h (inclua Bthsdpdef.h, BluetoothAPIs.h) |