BLUETOOTH_DEVICE_SEARCH_PARAMS 구조체(bluetoothapis.h)

아티클
08/22/2023

BLUETOOTH_DEVICE_SEARCH_PARAMS 구조는 Bluetooth 디바이스 검색에 대한 검색 조건을 지정합니다.

구문

typedef struct _BLUETOOTH_DEVICE_SEARCH_PARAMS {
  DWORD  dwSize;
  BOOL   fReturnAuthenticated;
  BOOL   fReturnRemembered;
  BOOL   fReturnUnknown;
  BOOL   fReturnConnected;
  BOOL   fIssueInquiry;
  UCHAR  cTimeoutMultiplier;
  HANDLE hRadio;
} BLUETOOTH_DEVICE_SEARCH_PARAMS;

멤버

dwSize

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

fReturnAuthenticated

검색에서 인증된 Bluetooth 디바이스를 반환해야 임을 지정하는 값입니다.

fReturnRemembered

검색에서 기억되는 Bluetooth 디바이스를 반환해야 임을 지정하는 값입니다.

fReturnUnknown

검색에서 알 수 없는 Bluetooth 디바이스를 반환해야 한다고 지정하는 값입니다.

fReturnConnected

검색에서 연결된 Bluetooth 디바이스를 반환해야 임을 지정하는 값입니다.

fIssueInquiry

새 문의를 발급해야 임을 지정하는 값입니다.

cTimeoutMultiplier

조회 시간 제한(1.28초 단위로 표시됨)을 나타내는 값입니다. 예를 들어 12.8초의 조회에는 cTimeoutMultiplier 값이 10입니다. 이 멤버의 최대값은 48입니다. 48보다 큰 값을 사용하면 호출 함수가 즉시 실패하고 E_INVALIDARG 반환합니다.

hRadio

조회를 수행할 라디오에 대한 핸들입니다. NULL로 설정하여 모든 로컬 Bluetooth 라디오에서 문의를 수행합니다.

요구 사항

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