BLUETOOTH_SELECT_DEVICE_PARAMS 구조체(bluetoothapis.h)

BLUETOOTH_SELECT_DEVICE_PARAMS 구조는 Bluetooth 장치 및 서비스의 표시 유형, 인증 및 선택을 용이하게 하고 관리합니다.

구문

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;

멤버

dwSize

BLUETOOTH_SELECT_DEVICE_PARAMS 구조체의 크기(바이트)입니다.

cNumOfClasses

prgClassOfDevices의 클래스 수입니다. 모든 디바이스를 검색하려면 0으로 설정합니다.

prgClassOfDevices

찾을 디바이스 클래스의 배열입니다.

pszInfo

NULL이 아닌 경우 정보 텍스트를 설정합니다.

hwndParent

부모 창에 대한 핸들입니다. 부모가 없는 경우 NULL 로 설정합니다.

fForceAuthentication

TRUE이면 반환하기 전에 인증을 강제합니다.

fShowAuthenticated

TRUE이면 인증된 디바이스가 선택기에서 표시됩니다.

fShowRemembered

TRUE이면 기억되는 디바이스가 선택기에서 표시됩니다.

fShowUnknown

TRUE이면 인증되지 않았거나 기억되지 않은 알 수 없는 디바이스가 선택기에서 표시됩니다.

fAddNewDeviceWizard

TRUE이면 새 디바이스 추가 마법사를 시작합니다.

fSkipServicesPage

TRUE이면 새 디바이스 추가 마법사에서 서비스 페이지를 건너뜁니다.

pfnDeviceCallback

각 디바이스에 대해 호출되는 콜백 함수에 대한 포인터입니다. 콜백 함수가 TRUE를 반환하면 항목이 추가됩니다. 콜백 함수가 FALSE를 반환하면 항목이 표시되지 않습니다. 콜백이 없도록 pfnDeviceCallback 을 null로 설정합니다. 자세한 내용은 PFN_DEVICE_CALLBACK 참조하세요.

pvParam

pfnDeviceCallback에서 가리키는 콜백 함수에 pvParam으로 전달할 매개 변수입니다.

cNumDevices

입력에서 원하는 호출 수를 지정합니다. 제한 없이 0으로 설정합니다. 출력에서 반환된 디바이스 수를 반환합니다.

pDevices

BLUETOOTH_DEVICE_INFO 구조체의 배열에 대한 포인터입니다.

설명

pDevices 멤버에 전달된 BLUETOOTH_DEVICE_INFO 구조체 배열을 해제하려면 BluetoothSelectDevicesFree 함수를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
머리글	bluetoothapis.h(Bthsdpdef.h, BluetoothAPIs.h 포함)

추가 정보

BLUETOOTH_COD_PAIRS

BLUETOOTH_DEVICE_INFO

BluetoothSelectDevices

BluetoothSelectDevicesFree

PFN_DEVICE_CALLBACK