BluetoothEnumerateInstalledServices 함수(bluetoothapis.h)

아티클
02/26/2024

BluetoothEnumerateInstalledServices 함수는 Bluetooth 디바이스에서 사용하도록 설정된 서비스 GUID(Globally Unique Identifiers)를 열거합니다.

구문

DWORD BluetoothEnumerateInstalledServices(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  DWORD                       *pcServiceInout,
  GUID                        *pGuidServices
);

매개 변수

hRadio

로컬 Bluetooth 라디오 디바이스의 핸들입니다. NULL인 경우 모든 로컬 라디오는 pbtdi의 라디오 주소와 일치하는 사용 가능한 서비스를 검색합니다.

pbtdi

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

pcServiceInout

입력에서 pGuidServices 매개 변수가 가리키는 레코드 수입니다. 출력에서 pGuidServices 매개 변수에 반환된 유효한 레코드의 수입니다. pGuidServices가 NULL인 경우 출력 pcServices 에는 활성화된 서비스 수가 포함됩니다.

pGuidServices

설치된 서비스에 대한 GUID를 받을 메모리의 버퍼에 대한 포인터입니다. 버퍼는 *pcServices *sizeof(GUID) 바이트 이상이어야 합니다.

반환 값

성공적으로 완료되면 ERROR_SUCCESS 반환하고 pGuidServices 매개 변수에는 사용 가능한 서비스 GUID의 전체 목록이 포함됩니다.

다음 표에서는 일반적인 오류를 설명합니다.

반환 코드	설명
ERROR_MORE_DATA	호출이 성공했습니다. pGuidServices 매개 변수에는 사용하도록 설정된 서비스 GUID의 불완전한 목록이 포함되어 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	bluetoothapis.h(Bthsdpdef.h, BluetoothAPIs.h 포함)
라이브러리	Bthprops.lib
DLL	bthprops.cpl