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 포함) |